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