mcp-server-prometheus

mcp-server-prometheus

与Prometheus交互的MCP server。

GitHub
Created Byloglmhqloglmhq

概述

MCP-Server-Prometheus 是一个基于 TypeScript 的桥接服务器，使 Claude 能够通过 Model Context Protocol (MCP) 与您的 Prometheus 实例交互，实现指标查询和数据访问。

主要功能

  • 列出所有可用的 Prometheus 指标及其描述
  • 提供详细的指标元数据和统计信息
  • 支持基础认证保护 Prometheus 实例

快速安装

  1. 配置环境变量

    • 必需: PROMETHEUS_URL - 您的 Prometheus 实例的 URL
    • 可选: PROMETHEUS_USERNAME 和 PROMETHEUS_PASSWORD - 基础认证凭据

  2. 与 Claude Desktop 集成

    在 Claude Desktop 配置文件中添加服务器配置:

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

    配置文件位置:

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

开发设置

# 安装依赖
npm install

# 构建服务器
npm run build

# 开发模式（自动重构）
npm run watch

# 调试（使用MCP Inspector）
npm run inspector

API 结构

服务器将 Prometheus 指标通过以下 URI 结构暴露:

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

每个指标返回包含名称、元数据和统计数据的 JSON 数据。

调试提示

由于 MCP 服务器通过 stdio 通信，推荐使用 MCP Inspector 进行调试。运行 npm run inspector 获取浏览器可访问的调试工具链接。