Alertmanager MCP

🚀 喧騒マネージャー MCP サーバー

このプロジェクトは、モデルコンテキストプロトコル (MCP) サーバーを実装しています。このサーバーは Prometheus Alertmanager と統合されており、Claude AI と Alertmanager の間の橋渡し役として機能し、Claude が標準化されたインターフェースを通じてアラートを相互作用および管理できるようにします。

✨ 主な機能

1. アラート検索：Alertmanager から現在のアラートを取得してフォーマットし、オプションでフィルタリング機能を使用できます。
2. アラート詳細情報：特定のアラートの指紋を指定すると、その詳細情報を提供します。
3. サイレンス管理：特定のアラートの通知を抑制するためのサイレンスを作成、一覧表示、削除するツールを提供します。
4. アラートグループ化：Alertmanager が組織したアラートグループを取得します。

🔧 技術詳細

• TypeScript と MCP SDK を使用して構築されています。
• Alertmanager の HTTP API (v2) と通信します。
• 標準入出力ベースのプロセスとして実行され、Claude Desktop に適しています。
• 適切なエラー処理とタイムアウト管理が実装されています。
• アラートとサイレンスデータを表す強い型付けのインターフェースを提供します。

📦 インストール

前提条件

• 実行中の Prometheus Alertmanager インスタンスにアクセスできること。
• Claude Desktop の場合：システムに Node.js (v18 以上) がインストールされていること。

セットアップ

このパッケージは npm で利用可能で、npx を使用して直接実行できます。

npx alertmanager-mcp

グローバルにインストールする場合は、以下のコマンドを実行します。

npm install -g alertmanager-mcp
alertmanager-mcp

💻 使用例

Claude Desktop との連携

1. Claude Desktop が MCP サーバーを使用するように、設定ファイルを編集して構成します。

{
  "mcpServers": {
    "alertmanager": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--network=host",
        "-e", "ALERTMANAGER_URL=http://your-alertmanager-url:9093",
        "ghcr.io/kaznak/alertmanager-mcp:latest"
      ],
      "env": {}
    }
  }
}

2. Claude Desktop を再起動して、新しい設定を読み込みます。
3. これで、Claude を使用して自然言語で Alertmanager と対話できます。
   • “現在のアラートを表示”
   • “CPU 関連のアラートをフィルタリング”
   • “このアラートの詳細情報を取得”
   • “このアラートに対して次の 2 時間のサイレンスを作成”

利用可能なツール

get-alerts

オプションのフィルタリング機能を持つアラートリストを取得します。 パラメーター：

• filter：(オプション) フィルタークエリ (例: alertname=~'.*CPU.*')
• silenced：(オプション) サイレンスされたアラートを含める
• inhibited：(オプション) 抑制されたアラートを含める
• active：(オプション) アクティブなアラートを含める

get-alert-details

アラート ID を指定して詳細情報を取得します。 パラメーター：

• alert-id：詳細情報を取得するアラートの ID

create-silence

特定の一致条件に対してサイレンスを作成します。 パラメーター：

• conditions：サイレンスが一致する条件
• startsAt：サイレンスの開始時間 (ISO 日付時刻)
• endsAt：サイレンスの終了時間 (ISO 日付時刻)
• comment：(オプション) サイレンスに関するコメント

list-silences

現在のすべてのサイレンスを一覧表示します。 パラメーター：なし

delete-silence

サイレンス ID を指定してサイレンスを削除します。 パラメーター：

• silence-id：削除するサイレンスの ID