mcp-server-prometheus

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

这是一个基于 TypeScript 的 MCP 服务器，实现了 Prometheus API 接口。它通过模型上下文协议 (MCP) 在 Claude 和你的 Prometheus 服务器之间提供了一个桥梁。

<a href="https://glama.ai/mcp/servers/y7b3qba8jy"><img width="380" height="200" src="https://glama.ai/mcp/servers/y7b3qba8jy/badge" alt="mcp-server-prometheus MCP server" /></a>

演示

功能

资源

• 列出和访问 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 数据：

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