项目简介

Prometheus MCP服务器是一个桥接服务，将Prometheus监控系统的所有功能通过Model Context Protocol标准化接口提供给AI客户端。您可以通过自然语言对话的方式查询监控指标、管理告警规则、执行数据库操作等。

主要功能

即时查询：在特定时间点执行PromQL查询
范围查询：获取历史时间范围内的指标数据
元数据发现：查询标签名称、标签值、时间序列等
目标与规则管理：监控抓取目标状态、管理告警和记录规则
状态监控：获取Prometheus配置、运行状态、构建信息等
TSDB管理：执行数据库快照、删除时间序列数据等高级操作
管理API：健康检查、配置重载、优雅关闭等

安装步骤

Docker方式（推荐）

# 拉取最新镜像
docker pull ghcr.io/yshngg/prometheus-mcp-server:latest

# 运行服务（适用于桌面客户端）
docker run --rm ghcr.io/yshngg/prometheus-mcp-server:latest --prom-addr="http://host.docker.internal:9090"

下载预编译二进制

访问GitHub Releases页面下载对应平台的二进制文件
解压并运行：

./prometheus-mcp-server --prom-addr="http://localhost:9090"

服务器配置

在MCP客户端中配置以下信息：

{
  "mcpServers": {
    "prometheus-mcp-server": {
      "command": "docker",
      "args": ["run", "--rm", "ghcr.io/yshngg/prometheus-mcp-server:latest",
      "args": ["--prom-addr", "http://localhost:9090"]
}

参数说明：

'command': 执行命令，可以是'docker'或直接的可执行文件路径
'args':
- '--prom-addr': Prometheus服务器地址（必需）
- '--transport': 通信传输方式，默认为'stdio'
- '--mcp-addr': 当使用HTTP传输时的监听地址

基本使用方法

确保有一个运行中的Prometheus实例
启动MCP服务器，指定Prometheus地址：

prometheus-mcp-server --prom-addr="http://localhost:9090"

启动后，您可以在支持的MCP客户端（如Claude Desktop）中通过自然语言使用所有Prometheus功能，例如：

"查询过去一小时的CPU使用率"
"显示所有活跃的告警"
"创建TSDB快照"
"重新加载配置"

undefined

关键词