mcp-server-prometheus

基本能力

产品定位

mcp-server-prometheus 是一个用于与 Prometheus 指标和数据交互的 MCP 服务器，旨在为 Claude 和 Prometheus 服务器之间提供桥梁。

核心功能

• 资源管理：
• 列出和访问 Prometheus 指标模式
• 每个指标资源提供：
  • 指标名称和描述
  • 来自 Prometheus 的详细元数据
  • 统计信息（计数、最小值、最大值）

• 提供 JSON mime 类型以支持结构化数据访问

• 当前能力：

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

适用场景

• 开发人员需要从 Claude 访问 Prometheus 指标数据
• 需要将 Prometheus 数据集成到 Claude 工作流中的场景
• 需要监控和分析 Prometheus 指标的场景

工具列表

• MCP Inspector：用于调试 MCP 服务器，提供浏览器访问的调试工具。

常见问题解答

• 如何配置服务器？
• 需要设置 PROMETHEUS_URL 环境变量指向您的 Prometheus 实例。

• 可选配置 PROMETHEUS_USERNAME 和 PROMETHEUS_PASSWORD 用于基本认证。

• 如何调试服务器？

• 推荐使用 MCP Inspector 进行调试，可以通过 npm run inspector 启动。

使用教程

使用依赖

安装 Node.js 和 npm。

安装教程

1. 克隆或下载项目。
2. 安装依赖： bash npm install
3. 构建服务器： bash npm run build
4. 开发模式下自动重建： bash 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 Inspector 进行调试：

npm run inspector

启动后，Inspector 将提供一个 URL，您可以在浏览器中访问调试工具。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。