Prometheus MCP Server

基本能力

产品定位

Prometheus MCP Server 是一个用于查询和监控 Prometheus 数据的中间件服务，旨在简化 Prometheus 数据的访问和查询。

核心功能

• Prometheus MCP Tools
• 列出可用指标 (prometheus_list_metrics)
• 发现并探索指标 (prometheus_get_targets)
• 获取特定指标的元数据 (prometheus_get_metric_metadata)
• 查看即时查询结果 (prometheus_execute_query)
• 查看不同步长间隔的范围查询结果 (prometheus_execute_range_query)
• 查看最近时长查询结果 (prometheus_execute_last_query)
• 身份验证支持
• 通过环境变量进行基本身份验证
• 通过环境变量进行 Bearer Token 身份验证
• Docker 容器化支持

适用场景

• 需要从 Prometheus 中查询监控数据的应用
• 需要简化 Prometheus 数据访问的开发者
• 需要容器化部署 Prometheus 查询服务的场景

工具列表

• prometheus_list_metrics: 列出 Prometheus 中可用的指标
• prometheus_get_targets: 发现并探索 Prometheus 中的目标
• prometheus_get_metric_metadata: 获取特定指标的元数据
• prometheus_execute_query: 执行即时查询并返回结果
• prometheus_execute_range_query: 执行范围查询并返回结果
• prometheus_execute_last_query: 执行最近时长查询并返回结果

常见问题解答

• 如何查看服务 URL？ 运行 docker logs prometheus-mcp-server 命令查看服务 URL。
• 如何切换运行模式？ 通过修改环境变量 MCP_SERVER_TRANSPORT 为 stdio 或 sse 来切换运行模式。

使用教程

使用依赖

• 确保已安装 Docker
• 确保 Prometheus 服务可访问

安装教程

1. 运行以下命令启动 Prometheus MCP Server 容器（无认证）：

docker run -d --name prometheus-mcp-server \
  -e PROMETHEUS_URL=http://your-prometheus-server:9090 \
  -e MCP_SERVER_TRANSPORT=sse \
  shaxiaozz/prometheus-mcp-server:latest

1. 如果需要基本身份验证，运行以下命令：

docker run -d --name prometheus-mcp-server \
  -e PROMETHEUS_URL=http://your-prometheus-server:9090 \
  -e PROMETHEUS_USERNAME=your_username \
  -e PROMETHEUS_PASSWORD=your_password \
  -e MCP_SERVER_TRANSPORT=sse \
  shaxiaozz/prometheus-mcp-server:latest

1. 如果需要 Token 身份验证，运行以下命令：

docker run -d --name prometheus-mcp-server \
  -e PROMETHEUS_URL=http://your-prometheus-server:9090 \
  -e PROMETHEUS_TOKEN=your_token \
  -e MCP_SERVER_TRANSPORT=sse \
  shaxiaozz/prometheus-mcp-server:latest

调试方式

• 查看容器日志：

docker logs prometheus-mcp-server

• 检查服务 URL 是否正确配置
• 确保 Prometheus 服务可访问

许可证

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