普罗米修斯MCP服务器

Name: 普罗米修斯MCP服务器
Author: CaesarYangs

作者：CaesarYangs33 星标更新：2025-04-05

安装使用来源：spider==github.com

项目介绍

Prometheus 的 MCP 服务器

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

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

功能

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

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

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

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

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

快速开始

运行 MCP 需要一个 Python 虚拟环境（venv），所有包应安装到此 venv 中，以便自动启动 MCP 服务器。

通过 Smithery 安装

要通过 Smithery 自动安装 Prometheus MCP 服务器：

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 环境

准备好根据更易于使用的 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 使用这种方式在应用程序启动时启动。

常规 Python 方法

python3 server.py

贡献

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

分叉仓库
创建您的功能分支 (git checkout -b feature/AmazingFeature)
提交更改 (git commit -m 'Add some AmazingFeature')
推送到分支 (git push origin feature/AmazingFeature)
打开拉取请求

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

感谢您的贡献！

许可证

MIT 许可证

参考与致谢

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

Prometheus API 客户端 - 修改的 Prometheus API 调用代码基于此库
MySQL MCP 服务器 - 类似的数据库导向的 MCP 服务器实现