使用说明

项目简介

'alertmanager-mcp' 是一个 MCP 服务器，它充当 Claude 等 LLM 应用与 Prometheus Alertmanager 之间的桥梁。通过此服务器，LLM 可以理解和操作 Alertmanager 中的告警信息，实现智能告警管理。

主要功能点

• 告警检索: 获取 Prometheus Alertmanager 的当前告警列表，并支持根据条件过滤，例如按告警名称、状态等筛选。
• 告警详情: 查询指定告警的详细信息，包括标签、注释、状态等，帮助用户深入了解特定告警。
• 静默管理: 提供创建、列出和删除告警静默的功能，允许用户在特定时期内抑制某些告警的通知，减少干扰。
• 告警分组: 获取 Alertmanager 组织的告警分组信息，了解告警的聚合情况。

安装步骤

• 前提条件: 确保已安装 Node.js (v18 或更高版本) 并可以访问 Prometheus Alertmanager 实例。
• 安装: 使用 npm 或 npx 安装和运行 'alertmanager-mcp'。

  npx alertmanager-mcp
  

  或者全局安装：

  npm install -g alertmanager-mcp
  alertmanager-mcp
  

服务器配置

在 MCP 客户端（例如 Claude for Desktop）的配置文件中，添加以下服务器配置信息。请将 'http://your-alertmanager-url:9093' 替换为您的 Alertmanager 实例的实际地址。

{
  "mcpServers": {
    "alertmanager": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--network=host",
        "-e", "ALERTMANAGER_URL=http://your-alertmanager-url:9093", // 设置 Alertmanager 的 URL 地址，请替换为您的 Alertmanager 实例地址
        "ghcr.io/kaznak/alertmanager-mcp:latest" // 使用 Docker 镜像运行 alertmanager-mcp
      ],
      "env": {}
    }
  }
}

基本使用方法

配置完成后，在 MCP 客户端中，您可以使用自然语言指示 LLM 与 Alertmanager 交互。例如：

• "Show me current alerts" (显示当前告警)
• "Create a silence for CPU alerts for 1 hour" (为 CPU 告警创建 1 小时静默)
• "List all silences created by admin" (列出所有由 admin 创建的静默)