Prometheus指标交互服务

一个基于TypeScript的MCP服务器,提供与Prometheus指标和数据交互的API接口,实现Claude与Prometheus服务器之间的桥梁功能。

  • by loglmhq
  • JavaScript
  • 本地部署
  • 17 星标
  • 更新于
在 GitHub 查看 loglmhq/mcp-server-prometheus

使用说明

mcp服务器普罗米修斯

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

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

演示

特性

资源

  • 列出并访问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数据:

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