Name: alertmanager-mcp-server
Author: ntk148v

1. はじめに

Prometheus Alertmanager MCPは、Prometheus Alertmanager用のモデルコンテキストプロトコル（MCP）サーバーです。AIアシスタントやツールがプログラム的に、かつ安全にAlertmanagerリソースを照会・管理することを可能にします。

2. 特徴

[x] Alertmanagerのステータス、アラート、サイレンス、レシーバー、アラートグループのクエリ
[x] サイレンスの作成、更新、削除
[x] 新しいアラートを作成する
[x] 認証サポート（環境変数経由の基本認証）
[x] Dockerコンテナ化のサポート

3. クイックスタート

3.1. 前提条件

Python 3.12以上
uv (高速な依存関係管理用)。
Docker (オプション、コンテナ化されたデプロイメント用)。
この MCP サーバーを実行する環境から Prometheus Alertmanager サーバーにアクセスできることを確認します。

3.2. Smithery経由でのインストール

Smithery経由で Claude Desktop 用の Prometheus Alertmanager MCP Server を自動的にインストールするには:

npx -y @smithery/cli install @ntk148v/alertmanager-mcp-server --client claude

3.3. ローカル実行

リポジトリをクローンします。

# Clone the repository $ git clone https://github.com/ntk148v/alertmanager-mcp-server.git

.env ファイルまたはシステム環境変数を使用して、Prometheus サーバーの環境変数を構成します。

# Set environment variables (see .env.sample) ALERTMANAGER_URL=http://your-alertmanager:9093 ALERTMANAGER_USERNAME=your_username # optional ALERTMANAGER_PASSWORD=your_password # optional

サーバー設定をクライアント設定ファイルに追加します。例えば、Claude Desktopの場合は以下のようになります。

{ "mcpServers": { "alertmanager": { "command": "uv", "args": [ "--directory", "<full path to alertmanager-mcp-server directory>", "run", "src/alertmanager_mcp_server/server.py" ], "env": { "ALERTMANAGER_URL": "http://your-alertmanager:9093s", "ALERTMANAGER_USERNAME": "your_username", "ALERTMANAGER_PASSWORD": "your_password" } } } }

または、make コマンドを使用してインストールします。

$ make install

新しい構成をロードするには、Claude Desktop を再起動します。
これで、Claude に自然言語を使用して Alertmanager と対話するように依頼できるようになりました。
- 「現在のアラートを表示」
- 「CPUの問題に関連するアラートをフィルタリングする」
- 「このアラートの詳細を取得する」
- 「このアラートを今後2時間無音状態にする」

3.4. Docker 実行

事前にビルドされたイメージで実行します (または自分でビルドすることもできます)。

$ docker run -e ALERTMANAGER_URL=http://your-alertmanager:9093 \ -e ALERTMANAGER_USERNAME=your_username \ -e ALERTMANAGER_PASSWORD=your_password \ -p 8000:8000 ghcr.io/ntk148v/alertmanager-mcp-server

Claude Desktop で Docker を実行する:

{ "mcpServers": { "alertmanager": { "command": "docker", "args": [ "run", "--rm", "-i", "-e", "ALERTMANAGER_URL", "-e", "ALERTMANAGER_USERNAME", "-e", "ALERTMANAGER_PASSWORD", "ghcr.io/ntk148v/alertmanager-mcp-server:latest" ], "env": { "ALERTMANAGER_URL": "http://your-alertmanager:9093s", "ALERTMANAGER_USERNAME": "your_username", "ALERTMANAGER_PASSWORD": "your_password" } } } }

この構成では、変数名のみを指定した-eフラグを使用し、 envオブジェクトに実際の値を指定して、Claude Desktop から Docker コンテナーに環境変数を渡します。

4. ツール

MCP サーバーは、API v2に従って、Alertmanager を照会および管理するためのツールを公開します。

ステータスを取得する: get_status()
アラートの一覧表示: get_alerts()
無音部分を一覧表示する: get_silences()
無音部分を作成: post_silence(silence_dict)
無音部分を削除: delete_silence(silence_id)
受信者の一覧を取得する: get_receivers()
アラートグループの一覧表示: get_alert_groups()

完全な API の詳細については、src/alertmanager_mcp_server/server.pyを参照してください。

5. 開発

貢献を歓迎します！ご提案や改善点がありましたら、問題を報告するか、プルリクエストを送信してください。

このプロジェクトは依存関係の管理にUVを使用しています。お使いのプラットフォームの指示に従ってUVをインストールしてください。

# Clone the repository $ git clone https://github.com/ntk148v/alertmanager-mcp-server.git $ cd alertmanager-mcp-server $ make setup # Run test $ make test # Run in development mode $ mcp dev $ TRANSPORT_MODE=sse mcp dev # Install in Claude Desktop $ make install