MCP Alertmanager

🚀 Alertmanager MCP Server (Go)

Prometheus Alertmanagerとの統合のためのModel Context Protocol (MCP)サーバーです。client-goを介してKubernetesとの接続機能を備えたネイティブGoバイナリです。

🚀 クイックスタート

このサーバーは、Prometheus Alertmanagerとの統合を目的としたMCPサーバーです。以下に、インストール方法や設定方法を説明します。

📦 インストール

npx

npx -y mcp-alertmanager@latest

MCPクライアント設定

MCPクライアント設定（VS Code、Cursor、Windsurfなど）に追加します。

{
  "mcpServers": {
    "alertmanager": {
      "command": "npx",
      "args": ["-y", "mcp-alertmanager@latest"],
      "env": {
        "ALERTMANAGER_URL": "http://localhost:9093"
      }
    }
  }
}

VS Code

code --add-mcp '{"name":"alertmanager","command":"npx","args":["-y","mcp-alertmanager@latest"],"env":{"ALERTMANAGER_URL":"http://localhost:9093"}}'

Kubernetes自動接続

K8S APIサービスプロキシを介して、OpenShift/Kubernetesで実行されているAlertmanagerに自動的に接続します。client-goを介してネイティブのkubeconfig/クラスタ内設定を使用します。kubectlやポートフォワーディングは必要ありません。 デフォルト: openshift-monitoring/alertmanager-operated:9093

{
  "mcpServers": {
    "alertmanager": {
      "command": "npx",
      "args": ["-y", "mcp-alertmanager@latest"]
    }
  }
}

バイナリ

GitHub Releasesからダウンロードするか、ソースからビルドします。

make build
./mcp-alertmanager

📚 詳細ドキュメント

設定

環境変数

CLIフラグ

優先順位: --url / ALERTMANAGER_URL > K8S自動接続

接続戦略:

1. 直接のURL（--urlまたはALERTMANAGER_URLが設定されている場合）
2. K8S APIプロキシ（kubeconfigまたはクラスタ内設定を自動検出）

ツール（12）

アラート

サイレンス

ステータス

トラブルシューティング

例のプロンプト

"What alerts are currently firing?"
"Are there any critical alerts?"
"Give me a summary of the alerting status"
"Investigate the HighMemoryUsage alert"
"Create a 2-hour silence for PodCrashLooping"
"What receivers are configured?"
"Find correlated alerts to identify the root cause"
"Show me alert history for KubeNodeNotReady"

開発

ビルド

make build              # 現在のプラットフォーム用にビルド
make build-all-platforms # すべてのプラットフォーム用にクロスコンパイル

コンテナ

podman build -f Containerfile -t mcp-alertmanager .

Kubernetes / OpenShiftデプロイメント

コンテナイメージ

コンテナイメージはGitHub Container Registryで利用可能です。

ghcr.io/jeanlopezxyz/mcp-alertmanager:latest

Helmチャート

含まれているHelmチャートを使用してデプロイします。

# チャートリポジトリを追加（またはローカルチャートを使用）
helm upgrade --install mcp-alertmanager ./charts/mcp-alertmanager \
  --namespace mcp-servers \
  --create-namespace \
  --set openshift=true

Helm値

カスタムAlertmanagerの例

helm upgrade --install mcp-alertmanager ./charts/mcp-alertmanager \
  --namespace mcp-servers \
  --set openshift=true \
  --set alertmanager.url=http://alertmanager.monitoring:9093

📄 ライセンス

MIT