Servidor MCP para Icinga

mcp-server-icinga es un servidor del Protocolo de Contexto de Modelo (MCP) que permite a clientes de IA como Claude trabajar con instalaciones de Icinga mediante lenguaje natural. Está dirigido a ingenieros de sistemas Linux que ejecutan Icinga en producción y desean una interfaz basada en chat para el triaje diario, la investigación de incidentes y las operaciones rutinarias sobre las API REST de Icinga existentes.

Este proyecto fue desarrollado con la asistencia de Claude Code de Anthropic.

Alcance

El servidor conecta tres superficies de Icinga y la pila de monitorización de Linuxfabrik:

• API REST de Icinga 2 Core (puerto 5665): objetos de host y servicio en vivo, comprobaciones bajo demanda, reconocimientos, tiempos de inactividad.

• Icinga Web 2 / Módulo Icinga DB Web: proyecciones de estado más ricas, historial, comentarios, notificaciones, con las limitaciones de la superficie de Icinga Web.

• API de Icinga Director: navegación de objetos, introspección de plantillas de servicio, catálogo de comandos.

• Catálogo de monitoring-plugins de Linuxfabrik: implementación, entradas, salidas, estados y datos de rendimiento de cada plugin de comprobación, para que el servidor pueda explicar por qué un servicio está alertando, no solo que lo está.

• Base de datos de series temporales (predeterminado: InfluxDB, modular): datos históricos de rendimiento para análisis de tendencias, análisis de flapping e investigación de causas raíz.

Cada backend reside en su propio módulo para que los operadores puedan conectar solo lo que realmente ejecutan. El servidor marca de forma transparente la información que la API subyacente no expone, en lugar de adivinarla.

Related MCP server: PilotOps MCP

Estado

Desarrollo temprano. La arquitectura, la configuración y la superficie de herramientas son inestables y cambiarán.

Requisitos

• Python 3.14 o superior.

• Instalación de Icinga accesible (uno o más de: API de Icinga 2 Core, Icinga Web 2 con el módulo Icinga DB Web, Icinga Director).

• Opcional: un backend de base de datos de series temporales para datos históricos de rendimiento. La integración predeterminada es InfluxDB; la capa TSDB es modular, por lo que se pueden conectar otros backends.

Instalación

Las instrucciones de instalación se documentarán una vez que se realice la primera versión.

Configuración

La documentación de configuración seguirá tan pronto como la superficie de configuración se estabilice.

Proyectos relacionados

• Linuxfabrik monitoring-plugins: el catálogo de plugins de comprobación que entiende este servidor.

• Linuxfabrik lib: ayudantes de Python compartidos.

• Icinga/icinga-mcp: servidor MCP de prueba de concepto ascendente del equipo de Icinga. Diferente alcance, diferente arquitectura.

Licencia

Publicado en el dominio público bajo la Unlicense.