Prometheus MCP Server

社区

为 AI 助手提供 Prometheus 指标访问和 PromQL 查询能力的 MCP 服务器。

分类: 开发工具第 26 / 438
Stars: ★ 518 非常热门
传输方式: stdio（本地进程）
运行环境: Docker
凭据: 无需凭据
许可证: MIT
最近提交: 2 天前
工具数: 6

67FMRS · C

该服务器为社区维护，提供完善的 Prometheus 集成功能，包括查询、发现和认证支持。安装灵活，支持多种客户端。风险点在于数据访问暴露，需合理配置网络和认证。总体适合希望将 Prometheus 指标接入 AI 助手的开发者和运维人员。

最强项 · 维护活跃度 15/20 最弱项 · 可靠性 11/20

可靠性

11/20

安全与权限

13/20

维护活跃度

15/20

文档质量

14/20

安装易用性

14/20

查看各项评分依据

可靠性 11/20: 证据：仓库包含真实的 CI 工作流（GitHub Actions）以及覆盖服务器关键路径（工具注册、查询处理、健康检查）的 pytest 测试套件，README 描述了测试命令（pytest --cov），manifest 声明了五个工具，与 README 的工具列表一致。扣除：本次评审仅静态阅读源代码，未实际执行；错误路径（如 HTTP/SSE 传输、TLS 客户端证书处理）的覆盖不完整；star 数和未执行测试不能作为运行时正确性的证据。
安全与权限 13/20: 证据：认证凭据（PROMETHEUS_PASSWORD、PROMETHEUS_TOKEN）在 manifest 中被标记为 secret；支持基本认证、Bearer token、mTLS 和自定义请求头；默认绑定 127.0.0.1；查询操作只读，无删除/部署/支付等破坏性工具；README 中未发现嵌入真实 token 的安装示例。扣除：PROMETHEUS_USERNAME 未标记为 secret（虽非敏感）；自定义头可携带凭据但未标记；无数据边界/租户隔离的明确文档；缺少危险操作确认机制，尽管当前工具集均只读。
维护活跃度 15/20: 证据：仓库有 MIT 许可证，非归档；最近的服务器版本 1.6.2 和 Helm chart 1.1.1；有 CI 和 Codecov 集成；存在 CONTRIBUTING.md；有 9 个开放 issue。扣除：未提供安全响应渠道的证据；开放 issue 响应时效未评估；依赖更新策略无明确证据；维护活跃度仅以仓库内可见事实为据。
文档质量 14/20: 证据：README 分层提供了快速开始（多种客户端示例）、配置选项表、工具/特性列表、Docker/Helm 安装说明和开发/测试指南；配置变量涵盖认证、超时、传输模式等。扣除：工具参数和副作用缺少完整参考（如分页、元数据过滤的具体默认值）；故障排查和成本/令牌限制说明不足；URL/认证组合限制未系统披露。
安装易用性 14/20: 证据：README 给出了 Claude Desktop、Claude Code、VS Code/Cursor/Windsurf、Docker Desktop、手动 Docker 和 Helm 的逐步配置示例；prebuilt OCI 镜像和 Dockerfile 使安装路径清晰；环境变量要求明确。扣除：静态评审未执行安装；SSE/HTTP 模式的完整客户端配置示例缺失；Helm chart 版本与服务器版本未对齐的潜在混淆；安装步骤仅在文档中可验证。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

需要将 Prometheus 指标查询能力集成到 AI 工作流的 DevOps 团队。
希望在 Claude Desktop 等 MCP 客户端中直接查询指标的用户。
追求轻量级、可通过 Docker 或 Helm 快速部署的场景。

不适合谁

不需要 Prometheus 集成或对 MCP 协议不感兴趣的用户。
需要官方支持或有严格认证要求的组织（该服务器由社区维护）。
对低延迟批量数据提取有极高要求的场景（MCP 交互可能不适合）。

所需权限

需要访问 Prometheus 服务器的网络权限，包括 PROMETHEUS_URL 指定的地址。
如果 Prometheus 启用了认证，需要提供用户名/密码或 token。
可配置自定义请求头，可能涉及向 Prometheus 发送额外信息。
如果使用 SSL，可能需要证书文件或配置 SSL 验证。

风险与副作用

暴露 Prometheus 查询端点可能增加数据泄露风险，需确保网络访问受限。
如果未设置请求超时，查询可能挂起，但该项目有默认 30 秒超时。
不正确的配置可能导致认证失败或连接错误。
MCP 服务器可能消耗大量上下文 token，但可禁用链接来缓解。

安装接入

准备工作

运行环境：Docker

PROMETHEUS_URL 必填 Prometheus 服务器地址（如 http://localhost:9090），必填，由你自己的 Prometheus 实例提供。

PROMETHEUS_PASSWORD 可选密钥 Prometheus 基本认证密码，可选，敏感信息，与你的 Prometheus 凭证一致。

PROMETHEUS_TOKEN 可选密钥 Prometheus Bearer 令牌，可选，敏感信息，来自你的认证体系。

其他可选配置项（14 个）

PROMETHEUS_URL_SSL_VERIFY 可选设为 False 可禁用 SSL 证书校验，用于自签证书环境。

PROMETHEUS_DISABLE_LINKS 可选设为 True 可禁用查询结果中的 Prometheus UI 链接，节省上下文 token。

PROMETHEUS_REQUEST_TIMEOUT 可选请求超时秒数（默认 30），防止请求挂起。

PROMETHEUS_USERNAME 可选 Prometheus 基本认证用户名，可选。

PROMETHEUS_CLIENT_CERT 可选 mTLS 客户端证书文件路径，可选。

PROMETHEUS_CLIENT_KEY 可选 mTLS 客户端私钥文件路径，可选。

REQUESTS_CA_BUNDLE 可选用于校验服务器 TLS 证书的 CA bundle 路径（标准 requests 库变量）。

ORG_ID 可选多租户 Prometheus 的组织 ID，可选。

PROMETHEUS_MCP_SERVER_TRANSPORT 可选传输模式：stdio、http 或 sse，默认 stdio。

PROMETHEUS_MCP_BIND_HOST 可选 HTTP/SSE 模式的绑定主机，默认 127.0.0.1。

PROMETHEUS_MCP_BIND_PORT 可选 HTTP/SSE 模式的绑定端口，默认 8080。

PROMETHEUS_MCP_STATELESS_HTTP 可选设为 True 启用无状态 HTTP 模式，支持多副本部署。

PROMETHEUS_CUSTOM_HEADERS 可选以 JSON 字符串形式提供的自定义请求头。

TOOL_PREFIX 可选所有工具名的前缀（如 staging 得到 staging_execute_query），便于运行多实例。

确保你有可访问的 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>"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "prometheus": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PROMETHEUS_URL",
        "ghcr.io/pab1it0/prometheus-mcp-server:latest"
      ],
      "env": {
        "PROMETHEUS_URL": "<your-prometheus-url>"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add prometheus -e 'PROMETHEUS_URL=<your-prometheus-url>' -- docker run -i --rm -e PROMETHEUS_URL ghcr.io/pab1it0/prometheus-mcp-server:latest

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

启动后在 MCP 客户端工具列表中应出现 execute_query、list_metrics 等工具；调用 health_check 或执行一条简单 PromQL 查询（如 up）并得到结果即证明连接正常。

常见排障

确保 PROMETHEUS_URL 正确且从运行环境中可访问。
检查认证变量是否设置正确（用户名/密码或 token）。
如果启用 SSL，确保证书路径或 CA 包正确。
查看服务器日志以获取错误信息，验证 JSON 配置。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出 Prometheus 中所有可用的指标
查询最近一小时的 CPU 使用率，按 1 分钟步长返回范围查询结果
查看指标 http_requests_total 的元数据
列出当前的抓取目标及其状态

工具能力 6

health_check 只读

系统健康检查端点，用于容器监控和状态验证。

execute_query 只读

对 Prometheus 执行 PromQL 即时查询。

execute_range_query 只读

以开始时间、结束时间和步长间隔执行 PromQL 范围查询。

list_metrics 只读

列出 Prometheus 中所有可用指标，支持分页和过滤。

get_metric_metadata 只读

获取单个指标或批量指标的元数据，支持可选过滤。

get_targets 只读

获取抓取目标，支持服务端 state/scrape_pool 过滤和可选分页。

使用场景

让 AI 助手直接查询 Prometheus 指标，进行实时监控分析。

通过自然语言交互，让 AI 执行 PromQL 查询并解释结果。

在开发或运维场景中，快速探索可用指标及其元数据。

集成到本地或云端环境，实现自动化监控和告警辅助。

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

这是一个基于模型上下文协议（MCP）的服务器，它通过标准化的接口，让 AI 智能体和 LLM 能够查询和分析 Prometheus 指标。它支持执行 PromQL 即时查询和范围查询，发现指标和元数据，获取抓取目标，并支持多种认证方式（基础认证、Bearer token、双向 TLS）。该服务器可通过 Docker 镜像或 Helm Chart 部署，配置灵活，能够节省上下文 token。