Name: alertmanager-mcp-server
Author: ntk148v

1. 简介

Prometheus Alertmanager MCP 是 Prometheus Alertmanager 的模型上下文协议(MCP) 服务器。它使 AI 助手和工具能够以编程方式安全地查询和管理 Alertmanager 资源。

2. 特点

[x] 查询 Alertmanager 状态、警报、静默、接收器和警报组
[x] 创建、更新和删除静默
[x] 创建新警报
[x] 身份验证支持（通过环境变量进行基本身份验证）
[x] Docker 容器化支持

3. 快速入门

3.1. 先决条件

Python 3.12+
uv （用于快速依赖管理）。
Docker（可选，用于容器化部署）。
确保您的 Prometheus Alertmanager 服务器可从运行此 MCP 服务器的环境访问。

3.2. 通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Prometheus Alertmanager MCP 服务器：

npx -y @smithery/cli install @ntk148v/alertmanager-mcp-server --client claude

3.3. 本地运行

克隆存储库：

# Clone the repository $ git clone https://github.com/ntk148v/alertmanager-mcp-server.git

通过 .env 文件或系统环境变量配置 Prometheus 服务器的环境变量：

# Set environment variables (see .env.sample) ALERTMANAGER_URL=http://your-alertmanager:9093 ALERTMANAGER_USERNAME=your_username # optional ALERTMANAGER_PASSWORD=your_password # optional

将服务器配置添加到客户端配置文件中。例如，对于 Claude Desktop：

{ "mcpServers": { "alertmanager": { "command": "uv", "args": [ "--directory", "<full path to alertmanager-mcp-server directory>", "run", "src/alertmanager_mcp_server/server.py" ], "env": { "ALERTMANAGER_URL": "http://your-alertmanager:9093s", "ALERTMANAGER_USERNAME": "your_username", "ALERTMANAGER_PASSWORD": "your_password" } } } }

或者使用 make 命令安装：

$ make install

重新启动 Claude Desktop 以加载新配置。
您现在可以要求 Claude 使用自然语言与 Alertmanager 进行交互：
- “显示当前警报”
- “过滤与 CPU 问题相关的警报”
- “获取此警报的详细信息”
- “在接下来的 2 小时内将此警报设置为静默”

3.4. Docker 运行

使用预先构建的图像运行它（或者您可以自己构建它）：

$ docker run -e ALERTMANAGER_URL=http://your-alertmanager:9093 \ -e ALERTMANAGER_USERNAME=your_username \ -e ALERTMANAGER_PASSWORD=your_password \ -p 8000:8000 ghcr.io/ntk148v/alertmanager-mcp-server

在 Claude Desktop 中使用 Docker 运行：

{ "mcpServers": { "alertmanager": { "command": "docker", "args": [ "run", "--rm", "-i", "-e", "ALERTMANAGER_URL", "-e", "ALERTMANAGER_USERNAME", "-e", "ALERTMANAGER_PASSWORD", "ghcr.io/ntk148v/alertmanager-mcp-server:latest" ], "env": { "ALERTMANAGER_URL": "http://your-alertmanager:9093s", "ALERTMANAGER_USERNAME": "your_username", "ALERTMANAGER_PASSWORD": "your_password" } } } }

此配置通过使用仅带有变量名的-e标志，并在env对象中提供实际值，将环境变量从 Claude Desktop 传递到 Docker 容器。

4.工具

MCP 服务器公开了用于查询和管理 Alertmanager 的工具，遵循其 API v2 ：

获取状态： get_status()
列出警报： get_alerts()
列出沉默： get_silences()
创建静默： post_silence(silence_dict)
删除静默： delete_silence(silence_id)
列出接收器： get_receivers()
列出警报组： get_alert_groups()

有关完整的 API 详细信息，请参阅src/alertmanager_mcp_server/server.py 。

5.开发

欢迎贡献代码！如果您有任何建议或改进，请提交 issue 或 pull request。

本项目使用uv来管理依赖项。请按照您平台的说明安装 uv。

# Clone the repository $ git clone https://github.com/ntk148v/alertmanager-mcp-server.git $ cd alertmanager-mcp-server $ make setup # Run test $ make test # Run in development mode $ mcp dev $ TRANSPORT_MODE=sse mcp dev # Install in Claude Desktop $ make install