mcp-alertmanager

Alertmanager MCP 服务（Go）

用于集成 Prometheus Alertmanager 的 Model Context Protocol (MCP) 服务。原生 Go 二进制程序，通过 client-go 内置 Kubernetes 连接功能。

安装

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

---

配置

环境变量

变量	描述
ALERTMANAGER_URL	直接指定 Alertmanager API URL（覆盖 K8S 自动连接）

CLI 标志

标志	描述	默认值
--url	直接指定 Alertmanager URL	-
--namespace	Kubernetes 命名空间	openshift-monitoring
--service	Kubernetes 服务名称	alertmanager-operated
--service-port	Kubernetes 服务端口	9093
--service-scheme	服务协议（http/https）	https
--kubeconfig	kubeconfig 文件路径	自动检测

优先级： --url / ALERTMANAGER_URL > K8S 自动连接

连接策略：

1. 直接 URL（如果设置了 --url 或 ALERTMANAGER_URL）
2. K8S API 代理（自动检测 kubeconfig 或集群内配置）

---

工具（12 个）

告警

工具	描述
getAlerts	获取告警，可选择筛选条件
getAlertGroups	按路由标签分组获取告警
getCriticalAlerts	仅获取严重级别告警
getAlertingSummary	摘要：按严重级别统计数量、列出热门告警和命名空间

静默

工具	描述
getSilences	按状态列出静默
createSilence	为告警创建静默
deleteSilence	按 ID 删除静默

状态

工具	描述
getAlertmanagerStatus	服务状态、版本、集群信息
getReceivers	列出通知接收方

故障排查

工具	描述
investigateAlert	深入调查特定告警
getAlertHistory	告警历史和分析指南
correlateAlerts	根据共享标签查找相关告警

---

提示词示例

"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              # Build for current platform
make build-all-platforms # Cross-compile for all platforms

容器

podman build -f Containerfile -t mcp-alertmanager .

---

Kubernetes / OpenShift 部署

容器镜像

容器镜像托管于 GitHub Container Registry：

ghcr.io/jeanlopezxyz/mcp-alertmanager:latest

Helm Chart

使用随附的 Helm Chart 部署：

# Add the chart repository (or use local chart)
helm upgrade --install mcp-alertmanager ./charts/mcp-alertmanager \
  --namespace mcp-servers \
  --create-namespace \
  --set openshift=true

Helm Values

参数	描述	默认值
image.registry	容器注册表	ghcr.io
image.repository	镜像仓库	jeanlopezxyz/mcp-alertmanager
image.version	镜像标签	latest
openshift	启用 OpenShift Routes	false
service.port	服务端口	8080
alertmanager.namespace	Alertmanager 命名空间	openshift-monitoring
alertmanager.service	Alertmanager 服务名称	alertmanager-operated
rbac.useClusterReader	使用 cluster-reader 角色	true

使用自定义 Alertmanager 的示例

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

---

许可证

MIT