mcp-server-prometheus

mcp-server-prometheus

镜像

概述

mcp-server-prometheus 是一个基于 TypeScript 的 MCP 服务器,为 Claude 提供与 Prometheus 指标数据交互的能力。

mcp-server-prometheus MCP 服务器

配置要求

必需环境变量:

  • PROMETHEUS_URL:您的 Prometheus 实例的基础 URL

可选身份验证变量:

  • PROMETHEUS_USERNAME:基本认证用户名
  • PROMETHEUS_PASSWORD:基本认证密码

安装步骤

  1. 安装依赖

    npm install
    
  2. 构建服务器

    npm run build
    
  3. 在 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"
          }
        }
      }
    }
    

主要功能

  • 列出并访问所有可用 Prometheus 指标
  • 查看详细的指标元数据和帮助文本
  • 获取指标的统计信息(计数、最小值、最大值)

调试

使用 MCP Inspector 进行调试:

npm run inspector

API 结构

  • 基础 URI: 您的 Prometheus 实例地址
  • 指标访问: /metrics/{metric_name}

每个指标以 JSON 格式返回,包含名称、元数据和当前统计数据。