Prometheus MCP Server

🚀 Prometheus MCP 服务器

Prometheus MCP 服务器是一个用于 Prometheus 的 Model Context Protocol (MCP) 服务器。它通过标准化的 MCP 接口，提供对 Prometheus 指标和查询的访问，允许 AI 助手执行 PromQL 查询并分析指标数据。

🚀 快速开始

1. 确保您的 Prometheus 服务器可以从运行此 MCP 服务器的环境中访问。
2. 配置环境变量以获取 Prometheus 服务器信息，无论是通过 .env 文件还是系统环境变量：

# 必须：Prometheus 配置
PROMETHEUS_URL=http://your-prometheus-server:9090

# 可选：身份验证凭证（如果需要）
# 根据需要选择以下一种身份验证方法：

# 对于基本认证
BASIC_AUTH_USERNAME=your_username
BASIC_AUTH_PASSWORD=your_password

# 对于bearer token 认证
BEARER_TOKEN=your_bearer_token

# 其他可选配置
SCrapeInterval=60  # 间隔（以秒为单位）
ScrapeTimeout=10    # scrape超时时间（以秒为单位）

3. 安装并运行服务器：

uv install
uv run

✨ 主要特性

• 执行 PromQL 查询：可执行 PromQL 查询到 Prometheus。
• 指标发现和探索：
  • 列出可用指标。
  • 获取特定指标的元数据。
  • 查看即时查询结果。
  • 查看范围查询结果以及不同的步长间隔。
• 支持身份验证：
  • 从环境变量使用基本认证。
  • 从环境变量使用 bearer token 认证。
• Docker 容器化支持：支持将服务打包为 Docker 容器。
• 提供交互式工具：为 AI 助手提供交互式工具，且工具列表可配置，您可以选择要提供给 MCP 客户端哪些工具，这在您不使用某些功能或不想占用太多上下文窗口时很有用。

💻 使用示例

基础用法

以下是配置环境变量的示例：

# 必须：Prometheus 配置
PROMETHEUS_URL=http://your-prometheus-server:9090

# 可选：身份验证凭证（如果需要）
# 根据需要选择以下一种身份验证方法：

# 对于基本认证
BASIC_AUTH_USERNAME=your_username
BASIC_AUTH_PASSWORD=your_password

# 对于bearer token 认证
BEARER_TOKEN=your_bearer_token

# 其他可选配置
SCrapeInterval=60  # 间隔（以秒为单位）
ScrapeTimeout=10    # scrape超时时间（以秒为单位）

高级用法

安装并运行服务器：

uv install
uv run

📚 详细文档

项目结构

该项目已经组织了一个 src 目录结构：

prometheus-mcp-server/
├── src/
│   └── prometheus_mcp_server/
│       ├── __init__.py      # 包初始化文件
│       ├── server.py        # MCP 服务器实现
│       └── main.py          # 主应用逻辑
├── Dockerfile               # Docker 配置文件
├── docker-compose.yml       # Docker Compose 配置文件
├── .dockerignore            # Docker 忽略文件
└── README.md                # 本文件

测试

项目包含全面的测试套件，确保功能并帮助防止回归。运行测试：

# 安装开发依赖项
uv pip install -e ".[dev]"

# 运行测试
pytest

# 生成覆盖率报告
pytest --cov=src --cov-report=term-missing

工具

📄 许可证

本项目采用 MIT 许可证。