Zabbix MCP Server

🚀 Zabbix MCP Server

FastMCPとpython-zabbix-utilsを使用した、Zabbix統合のための包括的なモデルコンテキストプロトコル（MCP）サーバーです。このサーバーは、MCP互換ツールを通じてZabbix API機能への完全なアクセスを提供します。

🚀 クイックスタート

このサーバーは、FastMCPとpython-zabbix-utilsを使用してZabbixとの統合を実現します。以下の手順に従って、サーバーをセットアップしてください。

✨ 主な機能

🏠 ホスト管理

• host_get - 高度なフィルタリングでホストを取得します。
• host_create - インターフェースとテンプレートを持つ新しいホストを作成します。
• host_update - 既存のホスト設定を更新します。
• host_delete - モニタリングからホストを削除します。

👥 ホストグループ管理

• hostgroup_get - ホストグループを取得します。
• hostgroup_create - 新しいホストグループを作成します。
• hostgroup_update - 既存のホストグループを変更します。
• hostgroup_delete - ホストグループを削除します。

📊 アイテム管理

• item_get - フィルタリングでモニタリングアイテムを取得します。
• item_create - 新しいモニタリングアイテムを作成します。
• item_update - 既存のアイテムを更新します。
• item_delete - モニタリングアイテムを削除します。

⚠️ トリガー管理

• trigger_get - トリガーとアラートを取得します。
• trigger_create - 新しいトリガーを作成します。
• trigger_update - 既存のトリガーを変更します。
• trigger_delete - トリガーを削除します。

📋 テンプレート管理

• template_get - モニタリングテンプレートを取得します。
• template_create - 新しいテンプレートを作成します。
• template_update - 既存のテンプレートを更新します。
• template_delete - テンプレートを削除します。

🚨 問題とイベント管理

• problem_get - 現在の問題と課題を取得します。
• event_get - 過去のイベントを取得します。
• event_acknowledge - イベントと問題を承認します。

📈 データ取得

• history_get - 過去のモニタリングデータにアクセスします。
• trend_get - トレンドデータと統計情報を取得します。

👤 ユーザー管理

• user_get - ユーザーアカウントを取得します。
• user_create - 新しいユーザーを作成します。
• user_update - ユーザー情報を更新します。
• user_delete - ユーザーアカウントを削除します。

🔧 メンテナンス管理

• maintenance_get - メンテナンス期間を取得します。
• maintenance_create - メンテナンスウィンドウをスケジュールします。
• maintenance_update - メンテナンス期間を変更します。
• maintenance_delete - メンテナンススケジュールを削除します。

📊 追加機能

• graph_get - グラフ設定を取得します。
• discoveryrule_get - 検出ルールを取得します。
• itemprototype_get - アイテムプロトタイプを取得します。
• configuration_export - Zabbix設定をエクスポートします。
• configuration_import - 設定をインポートします。
• apiinfo_version - APIバージョン情報を取得します。

📦 インストール

前提条件

• Python 3.10以上
• uv パッケージマネージャー
• APIが有効になっているZabbixサーバーへのアクセス

クイックスタート

1. リポジトリをクローンします：

   git clone https://github.com/mpeirone/zabbix-mcp-server.git
   cd zabbix-mcp-server
   

2. 依存関係をインストールします：

   uv sync
   

3. 環境変数を設定します：

   cp config/.env.example .env
   # .envをZabbixサーバーの詳細で編集します
   

4. インストールをテストします：

   uv run python scripts/test_server.py
   

📚 ドキュメント

必要な環境変数

• ZABBIX_URL - あなたのZabbixサーバーのAPIエンドポイント（例：https://zabbix.example.com）

認証（1つの方法を選択）

方法1: APIトークン（推奨）

• ZABBIX_TOKEN - あなたのZabbix APIトークン

方法2: ユーザー名/パスワード

• ZABBIX_USER - あなたのZabbixユーザー名
• ZABBIX_PASSWORD - あなたのZabbixパスワード

オプションの設定

• READ_ONLY - 読み取り専用モードを有効にするには、true、1、またはyesに設定します（GET操作のみ許可）

💻 使用例

サーバーの起動

起動スクリプトを使用する（推奨）：

uv run python scripts/start_server.py

直接実行する：

uv run python src/zabbix_mcp_server.py

テスト

テストスイートを実行する：

uv run python scripts/test_server.py

読み取り専用モード

READ_ONLY=trueの場合、サーバーはGET操作（データの取得）のみを公開し、すべての作成、更新、および削除操作をブロックします。これは以下の場合に役立ちます：

• 📊 モニタリングダッシュボード
• 🔍 読み取り専用の統合
• 🔒 セキュリティを重視する環境
• 🛡️ 誤った変更を防止する

ツール呼び出しの例

すべてのホストを取得する：

host_get()

特定のグループ内のホストを取得する：

host_get(groupids=["1"])

新しいホストを作成する：

host_create(
    host="server-01",
    groups=[{"groupid": "1"}],
    interfaces=[{
        "type": 1,
        "main": 1,
        "useip": 1,
        "ip": "192.168.1.100",
        "dns": "",
        "port": "10050"
    }]
)

最近の問題を取得する：

problem_get(recent=True, limit=10)

履歴データを取得する：

history_get(
    itemids=["12345"],
    time_from=1640995200,
    limit=100
)

MCP統合

このサーバーは、Claude DesktopなどのMCP互換クライアントで動作するように設計されています。詳細な統合手順については、MCP_SETUP.mdを参照してください。

Dockerサポート

Docker Composeの使用

1. 環境を設定します：

   cp config/.env.example .env
   # .envをあなたの設定で編集します
   

2. Docker Composeで実行します：

   docker compose up -d
   

Dockerイメージのビルド

docker build -t zabbix-mcp-server .

開発

プロジェクト構造

zabbix-mcp-server/
├── src/
│   └── zabbix_mcp_server.py    # メインサーバーの実装
├── scripts/
│   ├── start_server.py         # 検証付きの起動スクリプト
│   └── test_server.py          # テストスクリプト
├── config/
│   ├── .env.example           # 環境設定テンプレート
│   └── mcp.json               # MCPクライアント設定の例
├── pyproject.toml             # Pythonプロジェクト設定
├── requirements.txt           # 依存関係
├── Dockerfile                 # Docker設定
├── docker-compose.yml         # Docker Composeのセットアップ
├── README.md                  # このファイル
├── MCP_SETUP.md              # MCP統合ガイド
├── CONTRIBUTING.md           # コントリビューションガイドライン
├── CHANGELOG.md              # バージョン履歴
└── LICENSE                   # MITライセンス

コントリビュート

1. リポジトリをフォークします
2. 機能ブランチを作成します (git checkout -b feature/amazing-feature)
3. 変更をコミットします (git commit -m 'Add amazing feature')
4. ブランチにプッシュします (git push origin feature/amazing-feature)
5. プルリクエストを開きます

テストの実行

# サーバー機能をテストする
uv run python scripts/test_server.py

# Dockerでテストする
docker-compose exec zabbix-mcp python scripts/test_server.py

エラーハンドリング

サーバーには包括的なエラーハンドリングが含まれています：

• ✅ 認証エラーは明確に報告されます
• 🔒 読み取り専用モードの違反は説明的なメッセージでブロックされます
• ✔️ 無効なパラメーターは検証されます
• 🌐 ネットワークとAPIエラーは適切にフォーマットされます
• 📝 トラブルシューティングのための詳細なログ

セキュリティに関する考慮事項

• 🔑 可能な場合は、ユーザー名/パスワードの代わりにAPIトークンを使用します
• 🔒 モニタリングのみのユースケースでは、読み取り専用モードを有効にします
• 🛡️ 環境変数を安全に保管します
• 🔐 Zabbixサーバーの接続にはHTTPSを使用します
• 🔄 APIトークンを定期的に更新します
• 📁 設定ファイルを安全に保管します

トラブルシューティング

一般的な問題

接続失敗：

• ZABBIX_URLが正しく、アクセス可能であることを確認します
• 認証資格情報を確認します
• Zabbix APIが有効になっていることを確認します

アクセス拒否：

• ユーザーが十分なZabbix権限を持っていることを確認します
• データを変更しようとするときに読み取り専用モードが有効になっているかを確認します

ツールが見つからない：

• すべての依存関係がインストールされていることを確認します：uv sync
• Pythonバージョンの互換性（3.10以上）を確認します

デバッグモード

詳細なログを表示するには、環境変数を設定します：

export DEBUG=1
uv run python scripts/start_server.py

依存関係

• FastMCP - MCPサーバーフレームワーク
• python-zabbix-utils - 公式Zabbix Pythonライブラリ

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています - 詳細についてはLICENSEファイルを参照してください。

謝辞

• Zabbix モニタリングプラットフォーム
• Model Context Protocol 統合標準
• FastMCP サーバーフレームワーク

サポート

• 📖 ドキュメント
• 🐛 問題追跡
• 💬 ディスカッション

ZabbixとMCPコミュニティのために❤️ で作成されました