prometheus-mcp-server

prometheus-mcp-server

用于与 Prometheus 指标和数据交互的模型上下文协议（MCP）服务。

这是一个基于 TypeScript 的 MCP 服务，实现了 Prometheus API 接口。它通过模型上下文协议（MCP），在 Claude 与你的 Prometheus 服务之间搭建桥梁。

功能

• 即时查询：在指定时间执行 PromQL 查询
• 范围查询：在一段时间内执行 PromQL 查询
• 序列发现：通过标签匹配器查找序列
• 标签探索：获取标签名称和值
• 元数据访问：获取指标的元数据
• 目标信息：获取抓取目标的信息
• 告警和规则：获取告警和记录规则的信息
• 状态信息：获取 Prometheus 服务的状态信息

安装

# Install globally
npm install -g prometheus-mcp-server

# Or install locally
npm install prometheus-mcp-server

# Or use npx to run without installation
npx prometheus-mcp-server

在 Claude 中使用

要在 Claude Desktop 中使用，请添加服务配置：

在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "prometheus-mcp-server": {
      "command": "/path/to/prometheus-mcp-server/build/index.js",
      "env": {
        "PROMETHEUS_BASE_URL": "http://your-prometheus-instance:9090"
      }
    }
  }
}

使用 npx

你也可以在 Claude Desktop 配置中使用 npx：

{
  "mcpServers": {
    "prometheus-mcp-server": {
      "command": "npx prometheus-mcp-server",
      "env": {
        "PROMETHEUS_BASE_URL": "http://your-prometheus-instance:9090"
      }
    }
  }
}

配置

默认情况下，客户端连接到运行在 http://localhost:9090 的 Prometheus 服务。你可以通过设置 PROMETHEUS_BASE_URL 环境变量来配置 Prometheus 服务 URL：

# Example: Connect to a different Prometheus server
PROMETHEUS_BASE_URL=http://my-prometheus-server:9090 prometheus-mcp-server

这样无需修改源代码，即可将客户端连接到任意 Prometheus 实例。

可用函数

服务提供以下函数：

• mcp__instant_query：执行即时 PromQL 查询
• mcp__range_query：在一段时间内执行范围 PromQL 查询
• mcp__get_series：通过标签匹配器查找序列
• mcp__get_label_values：获取特定标签的值
• mcp__get_metadata：获取指标的元数据
• mcp__get_targets：获取抓取目标的信息
• mcp__get_alerts：获取告警信息
• mcp__get_rules：获取记录规则和告警规则的信息
• mcp__get_status：获取 Prometheus 服务的状态信息

开发

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

# Debug
npm run dev:debug

调试

由于 MCP 服务通过 stdio 通信，调试可能比较困难。你可以使用以下 npm 脚本进行调试：

# Inspect mode
npm run inspect

# Inspect with breakpoints
npm run inspect-debug

许可证

ISC

贡献

欢迎贡献！欢迎提交 Pull Request。