Prometheus MCP Server 7t1

🚀 Prometheus MCP 服务器

这是一个用于与 Prometheus 指标和数据交互的 Model Context Protocol (MCP) 服务器。它基于 TypeScript 实现了 Prometheus 台 API 接口，为 Claude 与您的 Prometheus 服务器之间搭建了一座桥梁，使其能够通过 Model Context Protocol (MCP) 进行交互。

🚀 快速开始

安装

# 全局安装
npm install -g prometheus-mcp-server

# 或者本地安装
npm install prometheus-mcp-server

# 或者使用 npx 运行无需安装
npx prometheus-mcp-server

与 Claude 一起使用

要在 Claude Desktop 中使用，请添加服务器配置：

• 在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

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

使用 npx

您也可以在 Claude Desktop 配置中使用 npx：

{
  "mcpServers": {
    "prometheus-mcp-server": {
      "command": "npx prometheus-mcp-server",
      "env": {
        "PROMETHEUS_HOST": "http://your-prometheus-instance:9090"
      }
    }
  }
}

✨ 主要特性

• 即时查询：执行特定时间点的 PromQL 查询
• 范围查询：在一段时间范围内执行 PromQL 查询
• 系列发现：根据标签匹配器查找系列数据
• 标签探索：获取特定标签的值
• 元数据访问：获取指标的元数据
• 目标信息：获取抓取目标的信息
• 警报与规则：获取警报和记录规则的信息
• 状态信息：获取 Prometheus 服务器的状态信息

📚 详细文档

配置

服务器需要以下环境变量：

• PROMETHEUS_HOST：您的 Prometheus 实例的基础 URL（默认值为 http://localhost:9090）

可用函数

服务器提供了以下函数：

• mcp__instant_query：执行即时 PromQL 查询
• mcp__range_query：在一段时间范围内执行 PromQL 查询
• mcp__get_series：根据标签匹配器查找系列数据
• mcp__get_label_values：获取特定标签的值
• mcp__get_metadata：获取指标的元数据
• mcp__get_targets：获取抓取目标的信息
• mcp__get_alerts：获取警报信息
• mcp__get_rules：获取记录和警报规则的信息
• mcp__get_status：获取 Prometheus 服务器的状态信息

💻 使用示例

基础用法

# 全局安装
npm install -g prometheus-mcp-server

# 启动服务器
prometheus-mcp-server

高级用法

{
  "mcpServers": {
    "prometheus-mcp-server": {
      "command": "npx prometheus-mcp-server",
      "env": {
        "PROMETHEUS_HOST": "http://your-prometheus-instance:9090"
      }
    }
  }
}

🔧 技术细节

开发

# 安装依赖项
npm install

# 构建项目
npm run build

# 启动服务器
npm start

# 调试
npm run dev:debug

调试

由于 MCP 服务器通过 stdio 进行通信，调试可能会比较困难。您可以使用以下 npm 脚本来进行调试：

# 检查模式
npm run inspect

# 带断点检查
npm run inspect-debug

📄 许可证

ISC

🤝 贡献

欢迎贡献！请随意提交 Pull Request。