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://gips0.baidu.com/it/u=3403551453,1009706447&fm=3081&app=3081&f=PNG?w=760&h=400" alt="mcp-server-prometheus MCP服务器" /></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服务器通过标准I/O进行通信，调试可能会比较困难。我们推荐使用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数据：

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