Caesaryangs Prometheus MCP Server

🚀 MCP 為 Prometheus 的服務器

MCP（模型上下文協議）服務器用於從 Prometheus 數據庫檢索數據。它讓大型語言模型（LLMs）能調用預定義路由中的可執行工具函數，實現檢索和分析大量指標數據、搜索指標使用情況、執行復雜查詢等任務，還增強了使用控制。

✨ 主要特性

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

具體功能展示

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

🚀 快速開始

📦 安裝指南

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

準備 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

💻 使用示例

帶 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 服務器可以自動啟動的一種方式，因為 Claude Desktop 使用這種 ux 腳本方法在應用程序啟動時啟動。

常規 Python 方法

python3 server.py

🤝 為項目做貢獻

歡迎貢獻！以下是一些快速指南：

1. 叉取倉庫
2. 創建功能分支（git checkout -b feature/AmazingFeature）
3. 提交更改（git commit -m 'Add some AmazingFeature'）
4. 推送到分支（git push origin feature/AmazingFeature）
5. 打開拉取請求

對於重大變更，請先打開問題討論您希望更改的內容。

感謝您的貢獻！

📄 許可證

MIT License

📚 詳細文檔

該項目靈感來源於或使用以下開源項目的代碼：

• Prometheus API 客戶端 - 該 Prometheus API 調用代碼基於此庫進行了修改
• MySQL MCP 服務器 - 類似的面向數據庫的 MCP 服務器實現