Prometheus MCP Server

io.github.pab1it0由 GitHub 账号 pab1it0 发布v1.6.2更新于 Oct 24, 2026

MCP server providing Prometheus metrics access and PromQL query execution for AI assistants

发布方自己的服务：Prometheus MCP

已验证STDIO仅桌面安全与监控数据与分析

概览

AI 生成的概览

把 AI 助手连接到 Prometheus 服务器，使其能执行 PromQL 即时与范围查询，并浏览指标和抓取目标。

可以做什么
  • 对 Prometheus 执行 PromQL 即时查询和带起止时间、步长的范围查询
  • 列出可用指标，获取单个或批量指标元数据，并可按名称或描述搜索
  • 查看抓取目标，支持按状态和抓取池过滤及分页
  • 检查服务健康状态，并可将查询结果在 Prometheus 界面中打开
适用场景
适合希望助手直接在 Prometheus 中排查指标、看板或故障，或在编写查询前先了解有哪些指标的场景，免去手工复制 PromQL 结果。
运行要求
以本地进程运行，通常通过 Docker 运行已发布的容器镜像（也提供 Kubernetes 的 Helm chart）。需要可访问的 Prometheus 地址（PROMETHEUS_URL）；可选基础认证 PROMETHEUS_USERNAME 与 PROMETHEUS_PASSWORD、令牌认证 PROMETHEUS_TOKEN、双向 TLS 的 PROMETHEUS_CLIENT_CERT 与 PROMETHEUS_CLIENT_KEY，以及自定义请求头 PROMETHEUS_CUSTOM_HEADERS。
安装前请注意
需要 Prometheus 实例的凭据：PROMETHEUS_PASSWORD、PROMETHEUS_TOKEN 和客户端私钥路径 PROMETHEUS_CLIENT_KEY 属于机密，应通过环境变量传入而非写入配置库。PROMETHEUS_URL_SSL_VERIFY 可设为 False，会关闭 TLS 证书校验。查询结果和指标元数据会发送给 AI 客户端，且除非设置 PROMETHEUS_DISABLE_LINKS，结果中会包含 Prometheus 界面链接。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Prometheus MCP Server，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Prometheus MCP Server

[GitHub Container Registry] [Helm Chart] [GitHub Release] [Codecov] [Python] [License]

Give AI assistants the power to query your Prometheus metrics.

A Model Context Protocol (MCP) server that provides access to your Prometheus metrics and queries through standardized MCP interfaces, allowing AI assistants to execute PromQL queries and analyze your metrics data.

Getting Started

Prerequisites

  • Prometheus server accessible from your environment
  • MCP-compatible client (Claude Desktop, VS Code, Cursor, Windsurf, etc.)

Installation Methods

Claude Desktop

Add to your Claude Desktop configuration:

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 Code

Install via the Claude Code CLI:

bash
claude mcp add prometheus --env PROMETHEUS_URL=http://your-prometheus:9090 -- docker run -i --rm -e PROMETHEUS_URL ghcr.io/pab1it0/prometheus-mcp-server:latest
VS Code / Cursor / Windsurf

Add to your MCP settings in the respective IDE:

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

The easiest way to run the Prometheus MCP server is through Docker Desktop:

[Add to Docker Desktop]

  1. Via MCP Catalog: Visit the Prometheus MCP Server on Docker Hub and click the button above

  2. Via MCP Toolkit: Use Docker Desktop's MCP Toolkit extension to discover and install the server

  3. Configure your connection using environment variables (see Configuration Options below)

Manual Docker Setup

Run directly with Docker:

bash
# With environment variablesdocker run -i --rm \  -e PROMETHEUS_URL="http://your-prometheus:9090" \  ghcr.io/pab1it0/prometheus-mcp-server:latest
# With authenticationdocker run -i --rm \  -e PROMETHEUS_URL="http://your-prometheus:9090" \  -e PROMETHEUS_USERNAME="admin" \  -e PROMETHEUS_PASSWORD="password" \  ghcr.io/pab1it0/prometheus-mcp-server:latest
Helm Chart (Kubernetes)

Deploy to Kubernetes using the Helm chart from the OCI registry:

bash
helm install prometheus-mcp-server \  oci://ghcr.io/pab1it0/charts/prometheus-mcp-server \  --version 1.1.1 \  --set prometheus.url="http://prometheus:9090"

With authentication:

bash
helm install prometheus-mcp-server \  oci://ghcr.io/pab1it0/charts/prometheus-mcp-server \  --version 1.1.1 \  --set prometheus.url="http://prometheus:9090" \  --set auth.username="admin" \  --set auth.password="secret"

With a custom values file:

bash
helm install prometheus-mcp-server \  oci://ghcr.io/pab1it0/charts/prometheus-mcp-server \  --version 1.1.1 \  -f values.yaml

See the chart values for all available configuration options.

Configuration Options

VariableDescriptionRequired
PROMETHEUS_URLURL of your Prometheus serverYes
PROMETHEUS_URL_SSL_VERIFYSet to False to disable SSL verificationNo
PROMETHEUS_DISABLE_LINKSSet to True to disable Prometheus UI links in query results (saves context tokens)No
PROMETHEUS_REQUEST_TIMEOUTRequest timeout in seconds to prevent hanging requests (DDoS protection)No (default: 30)
PROMETHEUS_USERNAMEUsername for basic authenticationNo
PROMETHEUS_PASSWORDPassword for basic authenticationNo
PROMETHEUS_TOKENBearer token for authenticationNo
PROMETHEUS_CLIENT_CERTPath to client certificate file for mutual TLS authenticationNo
PROMETHEUS_CLIENT_KEYPath to client private key file for mutual TLS authenticationNo
REQUESTS_CA_BUNDLEPath to CA bundle file for verifying the server's TLS certificate (standard requests library env var)No
ORG_IDOrganization ID for multi-tenant setupsNo
PROMETHEUS_MCP_SERVER_TRANSPORTTransport mode (stdio, http, sse)No (default: stdio)
PROMETHEUS_MCP_BIND_HOSTHost for HTTP transportNo (default: 127.0.0.1)
PROMETHEUS_MCP_BIND_PORTPort for HTTP transportNo (default: 8080)
PROMETHEUS_MCP_STATELESS_HTTPEnable stateless HTTP mode for multi-replica supportNo (default: False)
PROMETHEUS_CUSTOM_HEADERSCustom headers as JSON stringNo
TOOL_PREFIXPrefix for all tool names (e.g., staging results in staging_execute_query). Useful for running multiple instances targeting different environments in CursorNo

Available Tools

ToolCategoryDescription
health_checkSystemHealth check endpoint for container monitoring and status verification
execute_queryQueryExecute a PromQL instant query against Prometheus
execute_range_queryQueryExecute a PromQL range query with start time, end time, and step interval
list_metricsDiscoveryList all available metrics in Prometheus with pagination and filtering support
get_metric_metadataDiscoveryGet metadata for one metric or bulk metadata with optional filtering
get_targetsDiscoveryGet scrape targets, with server-side state/scrape_pool filtering and optional pagination

The list of tools is configurable, so you can choose which tools you want to make available to the MCP client. This is useful if you don't use certain functionality or if you don't want to take up too much of the context window.

Features

  • Execute PromQL queries against Prometheus
  • Discover and explore metrics
    • List available metrics
    • Get metadata for specific metrics
    • Search metric metadata by name or description in a single call
    • View instant query results
    • View range query results with different step intervals
    • Open range query results in the Prometheus UI with the same time window and resolution
  • Authentication support
    • Basic auth from environment variables
    • Bearer token auth from environment variables
  • Docker containerization support
  • Provide interactive tools for AI assistants

Development

Contributions are welcome! Please see our Contributing Guide for detailed information on how to get started, coding standards, and the pull request process.

This project uses uv to manage dependencies. Install uv following the instructions for your platform:

bash
curl -LsSf https://astral.sh/uv/install.sh | sh

You can then create a virtual environment and install the dependencies with:

bash
uv venvsource .venv/bin/activate  # On Unix/macOS.venv\Scripts\activate     # On Windowsuv pip install -e .

Testing

The project includes a comprehensive test suite that ensures functionality and helps prevent regressions.

Run the tests with pytest:

bash
# Install development dependenciesuv pip install -e ".[dev]"
# Run the testspytest
# Run with coverage reportpytest --cov=src --cov-report=term-missing

When adding new features, please also add corresponding tests.

License

MIT

来源：README.md，提交 a6bc50b

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.6.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Prometheus 集成

Prometheus MCP

sv.prometheus官方发布者

Prometheus 提供的远程 MCP 端点，让 AI 助手在面向智能体与创作者的知识网络中搜索、评分和评论编程指南。

Streamable HTTP可网页运行
知识与记忆尚未收录Oct 24, 2026

Prometheus MCP Server

由 GitHub 账号 prometheus 发布

一个API完整的MCP服务器，用于管理兼容Prometheus的后端。AI 翻译

STDIO仅桌面
安全与监控尚未验证Nov 3, 2026

Prometheus MCP Server

由 GitHub 账号 tjhop 发布

让助手查询和检查 Prometheus 兼容后端的 MCP 服务器：PromQL 查询、标签、序列、规则、告警、目标与文档。

STDIO仅桌面
云端与基础设施尚未验证Oct 27, 2026

Prometheus Mcp

由 GitHub 账号 mshegolev 发布

只读 MCP 服务器，让助手用 PromQL 查询 Prometheus 指标、列出指标名、查看活动告警和抓取目标。

STDIO仅桌面
安全与监控尚未验证Oct 24, 2026

Mcp Prometheus

由 GitHub 账号 jeanlopezxyz 发布

一个本地 MCP 服务器，将助手连接到 Prometheus，使其能执行 PromQL 查询并诊断 Kubernetes/OpenShift 集群健康状况。

STDIO仅桌面
云端与基础设施尚未验证Oct 24, 2026