mcp-server-prometheus

mcp-server-prometheus

用于与 Prometheus 指标和数据交互的 MCP 服务。

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

演示

功能

资源

• 列出并访问 Prometheus 指标架构
• 每个指标资源提供：
  • 指标名称和描述
  • 来自 Prometheus 的详细元数据
  • 统计信息（计数、最小值、最大值）
• 使用 JSON MIME 类型访问结构化数据

当前功能

• 列出所有可用的 Prometheus 指标及其描述
• 读取详细的指标信息，包括：
  • 元数据和帮助文本
  • 当前统计数据（计数、最小值、最大值）
• 支持对受保护的 Prometheus 实例进行基本身份验证

配置

服务需要以下环境变量：

• PROMETHEUS_URL：Prometheus 实例的基础 URL

可选的身份验证配置：

• PROMETHEUS_USERNAME：基本身份验证的用户名（如有需要）
• PROMETHEUS_PASSWORD：基本身份验证的密码（如有需要）

开发

安装依赖项：

npm install

构建服务：

npm run build

在开发期间启用自动重新构建：

npm run watch

安装

若要与 Claude Desktop 搭配使用，请添加服务配置：

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

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

调试

由于 MCP 服务通过 stdio 通信，调试可能颇具挑战。我们建议使用 MCP Inspector：

npm run inspector

Inspector 会提供一个 URL，让你在浏览器中访问调试工具。

API 结构

服务通过以下 URI 结构公开 Prometheus 指标：

• 基础 URI：http://your-prometheus-instance:9090
• 指标 URI：http://your-prometheus-instance:9090/metrics/{metric_name}

每个指标资源都会返回包含以下内容的 JSON 数据：

• 指标名称
• 元数据（帮助文本、类型）
• 当前统计数据（计数、最小值、最大值）