MCP Alertmanager

🚀 Alertmanager MCP Server (Go)

這是一個用於與 Prometheus Alertmanager 集成的 模型上下文協議 (MCP) 服務器。它是原生 Go 二進制文件，通過 client-go 實現了內置的 Kubernetes 連接功能。

🚀 快速開始

本項目提供了多種方式來安裝和配置 Alertmanager MCP Server，你可以根據自己的需求選擇合適的方式。

📦 安裝指南

使用 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 許可證。