
MCP Server for Prometheus

2024.12.27
0
PythonPrometheus 数据检索指标分析复杂查询数据库开发效率
CaesarYangs_prometheus_mcp_server 是一个基于 Model Context Protocol (MCP) 的服务器,专门用于从 Prometheus 数据库中检索和分析数据。该服务器使大型语言模型 (LLMs) 能够通过预定义的路由调用工具函数,检索和分析大量指标数据,搜索指标使用情况,执行复杂查询等任务。
核心功能包括:
- 数据检索:从 Prometheus 获取特定指标或数据范围。
- 指标分析:对检索到的指标进行统计分析。
- 使用情况搜索:查找和探索指标使用模式。
- 复杂查询:执行高级 PromQL 查询以深入探索数据。
适用场景:
- 需要从 Prometheus 获取和分析指标数据的场景。
- 需要执行复杂 PromQL 查询的场景。
- 需要自动化指标数据检索和分析的场景。
View on GitHub
Overview
基本能力
核心功能
- 数据检索:从 Prometheus 获取特定指标或数据范围。
- 指标分析:对检索到的指标进行统计分析。
- 使用情况搜索:查找和探索指标使用模式。
- 复杂查询:执行高级 PromQL 查询以深入探索数据。
工具列表
- Prometheus API Client:用于调用 Prometheus API 的代码库。
- MySQL MCP Server:类似的面向数据库的 MCP 服务器实现。
常见问题解答
- 如何安装 pip?
sh wget https://bootstrap.pypa.io/get-pip.py python3 get-pip.py
使用教程
使用依赖
-
准备 Python 虚拟环境:
sh cd ./src/prometheus_mcp_server python3 -m venv .venv
-
激活虚拟环境:
- Linux/macOS:
sh source .venv/bin/activate
-
Windows:
sh .venv\Scripts\activate
-
安装 pip(如果需要):
sh wget https://bootstrap.pypa.io/get-pip.py python3 get-pip.py
-
安装所需包:
sh pip install -r requirements.txt
安装教程
- 使用 MCP 客户端(包括 Claude Desktop):
-
配置 Claude Desktop 应用的配置文件:
json { "mcpServers": { "prometheus": { "command": "uv", "args": [ "--directory", "/path/to/prometheus_mcp_server", "run", "server.py" ], "env": { "PROMETHEUS_HOST": "http://localhost:9090" } } } }
-
独立运行 MCP 服务器:
- 使用 uv 方法:
sh uv --directory /path/to/prometheus_mcp_server run server.py
- 使用常规 Python 方法:
sh python3 server.py
调试方式
- 确保 Prometheus 主机地址正确配置:
sh export PROMETHEUS_HOST="http://localhost:9090"
- 启动服务器后,检查日志以确认服务器是否正常运行。