适合谁
- 需要将 Prometheus 指标查询能力集成到 AI 工作流的 DevOps 团队。
- 希望在 Claude Desktop 等 MCP 客户端中直接查询指标的用户。
- 追求轻量级、可通过 Docker 或 Helm 快速部署的场景。
P
67FMRS · C
该服务器为社区维护，提供完善的 Prometheus 集成功能，包括查询、发现和认证支持。安装灵活，支持多种客户端。风险点在于数据访问暴露，需合理配置网络和认证。总体适合希望将 Prometheus 指标接入 AI 助手的开发者和运维人员。
这是一个基于模型上下文协议（MCP）的服务器，它通过标准化的接口，让 AI 智能体和 LLM 能够查询和分析 Prometheus 指标。它支持执行 PromQL 即时查询和范围查询，发现指标和元数据，获取抓取目标，并支持多种认证方式（基础认证、Bearer token、双向 TLS）。该服务器可通过 Docker 镜像或 Helm Chart 部署，配置灵活，能够节省上下文 token。
工具能力
health_check
系统健康检查端点，用于容器监控和状态验证。
execute_query
对 Prometheus 执行 PromQL 即时查询。
execute_range_query
以开始时间、结束时间和步长间隔执行 PromQL 范围查询。
list_metrics
列出 Prometheus 中所有可用指标，支持分页和过滤。
get_metric_metadata
获取单个指标或批量指标的元数据，支持可选过滤。
get_targets
获取抓取目标，支持服务端 state/scrape_pool 过滤和可选分页。
安装接入
- 确保你有可访问的 Prometheus 服务器和 MCP 客户端（如 Claude Desktop）。
- 使用 Docker 运行：
docker run -i --rm -e PROMETHEUS_URL=<你的prometheus-url> ghcr.io/pab1it0/prometheus-mcp-server:latest。 - 根据客户端配置添加 MCP 服务器，例如 Claude Desktop 的配置示例见文档。
- 如需认证，设置 PROMETHEUS_USERNAME/PASSWORD 或 PROMETHEUS_TOKEN。
- 对于 Kubernetes 部署，可使用 Helm Chart：
helm install prometheus-mcp-server oci://ghcr.io/pab1it0/charts/prometheus-mcp-server --version 1.1.1 --set prometheus.url="http://prometheus:9090"。
claude_desktop_config.json
{
"mcpServers": {
"prometheus": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"PROMETHEUS_URL",
"ghcr.io/pab1it0/prometheus-mcp-server:latest"
],
"env": {
"PROMETHEUS_URL": "<your-prometheus-url>"
}
}
}
}
选型与风险
不适合谁
- 不需要 Prometheus 集成或对 MCP 协议不感兴趣的用户。
- 需要官方支持或有严格认证要求的组织（该服务器由社区维护）。
- 对低延迟批量数据提取有极高要求的场景（MCP 交互可能不适合）。
所需权限
- 需要访问 Prometheus 服务器的网络权限，包括 PROMETHEUS_URL 指定的地址。
- 如果 Prometheus 启用了认证，需要提供用户名/密码或 token。
- 可配置自定义请求头，可能涉及向 Prometheus 发送额外信息。
- 如果使用 SSL，可能需要证书文件或配置 SSL 验证。
风险与副作用
- 暴露 Prometheus 查询端点可能增加数据泄露风险，需确保网络访问受限。
- 如果未设置请求超时，查询可能挂起，但该项目有默认 30 秒超时。
- 不正确的配置可能导致认证失败或连接错误。
- MCP 服务器可能消耗大量上下文 token，但可禁用链接来缓解。
常见排障
- 确保 PROMETHEUS_URL 正确且从运行环境中可访问。
- 检查认证变量是否设置正确（用户名/密码或 token）。
- 如果启用 SSL，确保证书路径或 CA 包正确。
- 查看服务器日志以获取错误信息，验证 JSON 配置。
使用场景
让 AI 助手直接查询 Prometheus 指标，进行实时监控分析。
通过自然语言交互，让 AI 执行 PromQL 查询并解释结果。
在开发或运维场景中，快速探索可用指标及其元数据。
集成到本地或云端环境，实现自动化监控和告警辅助。
支持客户端
Claude Desktop完整支持