MCP-Server für Icinga

mcp-server-icinga ist ein Model Context Protocol (MCP)-Server, der es KI-Clients wie Claude ermöglicht, über natürliche Sprache mit Icinga-Installationen zu arbeiten. Er richtet sich an Linux-Systemadministratoren, die Icinga produktiv einsetzen und eine chatbasierte Schnittstelle für die tägliche Triage, Vorfalluntersuchung und Routineaufgaben auf Basis der bestehenden Icinga REST-APIs wünschen.

Dieses Projekt wurde mit Unterstützung von Claude Code von Anthropic entwickelt.

Umfang

Der Server verbindet drei Icinga-Oberflächen und den Linuxfabrik Monitoring-Stack:

• Icinga 2 Core REST API (Port 5665): Live-Host- und Service-Objekte, On-Demand-Checks, Bestätigungen (Acknowledgements), Downtimes.

• Icinga Web 2 / Icinga DB Web Modul: Reichhaltigere Status-Projektionen, Historie, Kommentare, Benachrichtigungen, mit den Einschränkungen der Icinga Web-Oberfläche.

• Icinga Director API: Objekt-Browsing, Introspektion von Service-Templates, Befehlskatalog.

• Linuxfabrik monitoring-plugins Katalog: Implementierung, Eingaben, Ausgaben, Zustände und Perfdata jedes Check-Plugins, damit der Server erklären kann, warum ein Service alarmiert, nicht nur, dass er es tut.

• Zeitreihendatenbank (Standard: InfluxDB, modular): Historische Perfdata für Trendanalysen, Flapping-Analyse und Ursachenforschung.

Jedes Backend befindet sich in einem eigenen Modul, sodass Administratoren nur das anbinden können, was sie tatsächlich betreiben. Der Server kennzeichnet Informationen, die von der zugrunde liegenden API nicht bereitgestellt werden, transparent, anstatt zu raten.

Related MCP server: PilotOps MCP

Status

Frühe Entwicklung. Architektur, Konfiguration und Tool-Oberfläche sind instabil und werden sich ändern.

Anforderungen

• Python 3.14 oder neuer.

• Erreichbare Icinga-Installation (eine oder mehrere der folgenden: Icinga 2 Core API, Icinga Web 2 mit dem Icinga DB Web Modul, Icinga Director).

• Optional: ein Zeitreihendatenbank-Backend für historische Perfdata. Die Standardintegration ist InfluxDB; die TSDB-Schicht ist modular, sodass andere Backends angebunden werden können.

Installation

Installationsanweisungen werden dokumentiert, sobald die erste Version veröffentlicht wird.

Konfiguration

Die Konfigurationsdokumentation folgt, sobald sich die Konfigurationsoberfläche stabilisiert hat.

Verwandte Projekte

• Linuxfabrik monitoring-plugins: Der Check-Plugin-Katalog, den dieser Server versteht.

• Linuxfabrik lib: Gemeinsame Python-Hilfsfunktionen.

• Icinga/icinga-mcp: Upstream Proof-of-Concept MCP-Server des Icinga-Teams. Anderer Umfang, andere Architektur.

Lizenz

Veröffentlicht als Public Domain unter der Unlicense.