MCP Server Prometheus

mcp服务器普罗米修斯

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

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

演示

demo

特性

资源

• 列出并访问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检查员:

npm run inspector

检查器将提供一个URL，用于访问浏览器中的调试工具。

API结构

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

• 基本URI： http://your-prometheus-instance:9090
• 度量URI： http://your-prometheus-instance:9090/metrics/{metric_name}

每个度量资源返回包含以下内容的JSON数据：

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