mcp-server-prometheus

🚀 mcp-server-prometheus

mcp-server-prometheus是一个与Prometheus指标和数据交互的MCP服务器。它基于TypeScript构建，实现了Prometheus API接口，通过模型上下文协议（MCP）在Claude和Prometheus服务器之间搭建了桥梁。

🚀 快速开始

mcp-server-prometheus是一个强大的工具，它能让Claude与Prometheus服务器实现交互。下面将为你介绍它的使用步骤。

✨ 主要特性

资源

• 可列出并访问Prometheus指标模式。
• 每个指标资源提供以下信息：
  • 指标名称和描述。
  • 来自Prometheus的详细元数据。
  • 统计信息（计数、最小值、最大值）。
• 支持JSON MIME类型，方便获取结构化数据。

当前功能

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

📦 安装指南

环境变量配置

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

• PROMETHEUS_URL：您的Prometheus实例的基础URL。

可选的身份验证配置：

• PROMETHEUS_USERNAME：基本认证的用户名（如果需要）。
• PROMETHEUS_PASSWORD：基本认证的密码（如果需要）。

与Claude Desktop集成

要与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"
      }
    }
  }
}

依赖安装与构建

安装依赖项：

npm install

构建服务器：

npm run build

使用自动重建进行开发：

npm run watch

调试

由于MCP服务器通过标准输入输出进行通信，调试可能具有挑战性。我们建议使用MCP Inspector：

npm run inspector

Inspector将提供一个在浏览器中访问调试工具的URL。

💻 使用示例

基础用法

以下是使用该服务器的基本步骤：

1. 配置好环境变量。
2. 安装依赖并构建服务器。
3. 按照上述配置与Claude Desktop集成。

高级用法

如果需要对受保护的Prometheus实例进行操作，可配置PROMETHEUS_USERNAME和PROMETHEUS_PASSWORD进行基本身份验证。

📚 详细文档

演示

API结构

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

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

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

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