prometheus-mcp-server
2025.03.16
1
JavaScript监控数据查询Prometheus 接口Claude 集成开发效率数据库
prometheus-mcp-server 是一个基于 TypeScript 的 Model Context Protocol (MCP) 服务器，用于与 Prometheus 指标和数据交互。它通过 MCP 协议在 Claude 和 Prometheus 服务器之间建立桥梁，提供丰富的 Prometheus API 接口功能。
View on GitHub
Overview
基本能力
产品定位
prometheus-mcp-server 是一个中间件服务，旨在为 Claude 提供与 Prometheus 监控系统交互的能力，使 Claude 能够查询和分析 Prometheus 中的监控数据。
核心功能
- 即时查询：在特定时间执行 PromQL 查询
- 范围查询：在一段时间内执行 PromQL 查询
- 系列发现：通过标签匹配器查找系列
- 标签探索：获取标签名称和值
- 元数据访问：获取指标的元数据
- 目标信息：获取抓取目标的信息
- 警报和规则：获取警报和记录规则的信息
- 状态信息：获取 Prometheus 服务器状态信息
适用场景
- 在 Claude 中查询和分析 Prometheus 监控数据
- 自动化监控数据分析和报告生成
- 集成 Prometheus 监控数据到 Claude 工作流中
工具列表
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 服务器状态信息
常见问题解答
- 调试困难：由于 MCP 服务器通过 stdio 通信，调试可能具有挑战性
- 环境变量配置：必须设置 PROMETHEUS_HOST 环境变量
使用教程
使用依赖
需要安装 Node.js 和 npm
安装教程
# 全局安装
npm install -g prometheus-mcp-server
# 或本地安装
npm install prometheus-mcp-server
# 或使用 npx 运行而无需安装
npx prometheus-mcp-server
调试方式
# 检查模式
npm run inspect
# 带断点的检查
npm run inspect-debug