用于 Prometheus 的 MCP 服务器

一个用于从 Prometheus 数据库检索数据的模型上下文协议 (MCP) 服务器。 此 MCP 服务器使大型语言模型 (LLM) 能够调用工具函数，这些函数可以检索和分析大量指标数据、搜索指标使用情况、执行复杂查询，并通过预定义的路由执行其他相关任务，从而增强对使用情况的控制。

• 数据检索：从 Prometheus 获取特定指标或数据范围。
• 指标分析：对检索到的指标执行统计分析。
• 使用情况搜索：查找和探索指标使用模式。
• 复杂查询：执行高级 PromQL 查询以进行深入的数据探索。

功能

✅ 从 Prometheus 检索全面的指标信息，包括名称和描述

✅ 使用指标名称获取和分析特定指标数据

✅ 在自定义时间范围内分析指标数据

🚧 使用特定标签过滤和匹配数据（开发中）

⏳ 计划中的其他功能...

开始使用

MCP 运行需要一个 python 虚拟环境 (venv)，所有软件包都应安装到此 venv 中，以便可以自动启动 MCP 服务器。

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Prometheus MCP Server：

npx -y @smithery/cli install @CaesarYangs/prometheus_mcp_server --client claude

手动安装

准备 python 环境

cd ./src/prometheus_mcp_server
python3 -m venv .venv

# linux/macos:
source .venv/bin/activate

# windows:
.venv\Scripts\activate

然后就可以将其用作专用 python 环境。

安装所需的软件包

确保 pip 已正确安装。 如果您的 venv 在安装时没有 pip，请使用以下命令手动安装：

wget https://bootstrap.pypa.io/get-pip.py
python3 get-pip.py

然后安装所有必需的软件包：

pip install -r requirements.txt

用法

使用 Cursor Env

准备好更新以依赖更易于使用的 Cursor 环境。

在 Cursor 设置的 MCP 部分中设置此项：

uv --directory /path/to/prometheus_mcp_server run server.py

使用 MCP 客户端（包括 Claude Desktop）

在 ~/Library/Application Support/Claude/claude_desktop_config.json (macos) 中配置您的 Claude Desktop 应用程序的配置

{
    "mcpServers": {
        "prometheus": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/prometheus_mcp_server",
                "run",
                "server.py"
            ],
            "env": {
                "PROMETHEUS_HOST": "http://localhost:9090"
            }
        }
    }
}

独立 MCP 服务器

单独启动此 MCP 服务器：

uv 方法

uv --directory /path/to/prometheus_mcp_server run server.py

这也是确保此 MCP 服务器可以自动启动的一种方法，因为 Claude Desktop 在应用程序启动时使用此 ux 脚本方式启动。

常规 python 方法

python3 server.py

贡献

欢迎贡献！ 这是一个快速指南：

1. Fork 仓库
2. 创建您的功能分支 (git checkout -b feature/AmazingFeature)
3. 提交您的更改 (git commit -m 'Add some AmazingFeature')
4. 将分支推送到远程仓库 (git push origin feature/AmazingFeature)
5. 打开一个 Pull Request

对于重大更改，请先打开一个 issue 讨论您想要更改的内容。

感谢您的贡献！

许可证

MIT 许可证

参考文献和致谢

本项目受到以下开源项目的启发或使用了其中的代码：

• Prometheus API Client - Prometheus API 调用代码基于此库修改
• MySQL MCP Server - 类似的面向数据库的 MCP 服务器实现