Prometheus MCP Server

🚀 用於 Prometheus 的 MCP 服務器

本項目是一個用於 Prometheus 的 MCP 服務器，它能夠從 Prometheus 數據庫獲取數據。藉助這個 MCP 服務器，大型語言模型 (LLMs) 可以調用工具函數，執行檢索和分析大量指標數據、搜索指標使用情況、執行復雜查詢等相關任務。

🚀 快速開始

運行 MCP 服務器需要一個 Python 虛擬環境 (venv)，所有包都應安裝到此 venv 中，以便 MCP 服務器可以自動啟動。

通過 Smithery 安裝

要通過 Smithery 自動安裝 Prometheus MCP Server for Claude Desktop，可使用以下命令：

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

✨ 主要特性

• 數據檢索：可按名稱或時間段範圍從 Prometheus 獲取特定指標。
• 指標分析：能對檢索到的指標執行統計分析。
• 使用情況搜索：可以查找和探索指標使用模式。
• 複雜查詢：支持執行高級 PromQL 查詢以進行深入的數據探索。

具體功能狀態如下：

• ✅ 檢索 Prometheus 中全面的指標信息，包括名稱和描述。
• ✅ 使用指標名稱獲取並分析特定指標數據。
• ✅ 在自定義時間段內分析指標數據。
• 🚧 使用特定標籤過濾和匹配數據（開發中）。
• ⏳ 計劃中的其他功能...

💻 使用示例

帶有 Cursor Env

準備好根據更易於使用的 Cursor 環境進行更新。在此處設置此 MCP 服務器在 Cursor 設置中的位置：

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

帶有 MCP 客戶端（包括 Claude Desktop）

配置您的 Claude Desktop 應用的配置文件 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)：

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

獨立運行的 MCP 服務器

使用 uv 方法

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

這也是確保 MCP 服務器正確運行的一種方法。

獨立運行

python3 src/prometheus_mcp_server/server.py

🤝 貢獻

如果您想對項目做出貢獻，請訪問 這裡 提交您的 PR 或 Issue。

📄 許可證

[此處填寫許可證信息]

📚 詳細文檔

• Prometheus 官方文檔
• MCP 協議