MCP Server for Prometheus

MCP Server for Prometheus

site icon
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

使用教程

使用依赖

  1. 准备 Python 虚拟环境: sh cd ./src/prometheus_mcp_server python3 -m venv .venv

  2. 激活虚拟环境:

  3. Linux/macOS: sh source .venv/bin/activate
  4. Windows: sh .venv\Scripts\activate

  5. 安装 pip(如果需要): sh wget https://bootstrap.pypa.io/get-pip.py python3 get-pip.py

  6. 安装所需包: sh pip install -r requirements.txt

安装教程

  1. 使用 MCP 客户端(包括 Claude Desktop):
  2. 配置 Claude Desktop 应用的配置文件: json { "mcpServers": { "prometheus": { "command": "uv", "args": [ "--directory", "/path/to/prometheus_mcp_server", "run", "server.py" ], "env": { "PROMETHEUS_HOST": "http://localhost:9090" } } } }

  3. 独立运行 MCP 服务器:

  4. 使用 uv 方法: sh uv --directory /path/to/prometheus_mcp_server run server.py
  5. 使用常规 Python 方法: sh python3 server.py

调试方式

  • 确保 Prometheus 主机地址正确配置: sh export PROMETHEUS_HOST="http://localhost:9090"
  • 启动服务器后,检查日志以确认服务器是否正常运行。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。