MCP Server for Icinga

mcp-server-icingaは、ClaudeのようなAIクライアントが自然言語を通じてIcinga環境を操作できるようにするModel Context Protocol (MCP) サーバーです。本番環境でIcingaを運用しており、既存のIcinga REST API上で日々のトリアージ、インシデント調査、日常的な運用をチャットベースのインターフェースで行いたいLinuxシステムエンジニアを対象としています。

このプロジェクトは、AnthropicのClaude Codeの支援を受けて開発されました。

スコープ

このサーバーは、3つのIcingaインターフェースとLinuxfabrikの監視スタックを橋渡しします。

• Icinga 2 Core REST API (ポート 5665): ライブホストおよびサービスオブジェクト、オンデマンドチェック、承認、ダウンタイム。

• Icinga Web 2 / Icinga DB Webモジュール: Icinga Webインターフェースの制限内で、より詳細な状態予測、履歴、コメント、通知を提供します。

• Icinga Director API: オブジェクトのブラウジング、サービステンプレートのイントロスペクション、コマンドカタログ。

• Linuxfabrik monitoring-plugins カタログ: 各チェックプラグインの実装、入力、出力、状態、パフォーマンスデータ。これにより、サーバーはサービスが単にアラートを出しているだけでなく、なぜアラートを出しているのかを説明できます。

• 時系列データベース (デフォルト: InfluxDB、モジュール式): トレンド分析、フラッピング分析、根本原因調査のための過去のパフォーマンスデータ。

各バックエンドは独自のモジュールとして存在するため、運用者は実際に実行しているものだけを接続できます。サーバーは、基盤となるAPIが公開していない情報を推測するのではなく、透過的にフラグを立てます。

Related MCP server: PilotOps MCP

ステータス

初期開発段階です。アーキテクチャ、構成、ツールインターフェースは不安定であり、変更される可能性があります。

要件

• Python 3.14以降。

• 到達可能なIcinga環境 (Icinga 2 Core API、Icinga DB Webモジュールを備えたIcinga Web 2、Icinga Directorのいずれか1つ以上)。

• オプション: 過去のパフォーマンスデータ用の時系列データベースバックエンド。デフォルトの統合はInfluxDBですが、TSDBレイヤーはモジュール式であるため、他のバックエンドを接続可能です。

インストール

インストール手順は、最初のリリースが公開された後に文書化されます。

設定

設定に関するドキュメントは、設定インターフェースが安定次第公開されます。

関連プロジェクト

• Linuxfabrik monitoring-plugins: このサーバーが理解するチェックプラグインカタログ。

• Linuxfabrik lib: 共有Pythonヘルパー。

• Icinga/icinga-mcp: Icingaチームによるアップストリームの概念実証用MCPサーバー。スコープとアーキテクチャが異なります。

ライセンス

Unlicenseに基づき、パブリックドメインとして公開されています。