Prometheus MCP 服务器

这是一个用于与 Prometheus 指标和数据交互的 Model Context Protocol (MCP) 服务器。

这是一个基于 TypeScript 的 MCP 服务器，实现了 Promethest 台 API 接口。它提供了一个桥梁，使得 Claude 能够通过 Model Context Protocol (MCP) 与您的 Prometheus 服务器进行交互。

功能

• 即时查询: 执行特定时间点的 PromQL 查询
• 范围查询: 在一段时间范围内执行 PromQL 查询
• 系列发现: 根据标签匹配器查找系列数据
• 标签探索: 获取特定标签的值
• 元数据访问: 获取指标的元数据
• 目标信息: 获取抓取目标的信息
• 警报与规则: 获取警报和记录规则的信息
• 状态信息: 获取 Prometheus 服务器的状态信息

安装

# 全局安装
npm install -g prometheus-mcp-server

# 或者本地安装
npm install prometheus-mcp-server

# 或者使用 npx 运行无需安装
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_HOST": "http://your-prometheus-instance:9090"
      }
    }
  }
}

使用 npx

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

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

配置

服务器需要以下环境变量：

• PROMETHEUS_HOST: 您的 Prometheus 实例的基础 URL（默认值为 http://localhost:9090）

可用函数

服务器提供了以下函数：

• 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 服务器的状态信息

开发

# 安装依赖项
npm install

# 构建项目
npm run build

# 启动服务器
npm start

# 调试
npm run dev:debug

调试

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

# 检查模式
npm run inspect

# 带断点检查
npm run inspect-debug

许可证

ISC

贡献

欢迎贡献！请随意提交 Pull Request。