Prometheus MCP Server

🚀 Prometheus用MCPサーバ

Prometheusデータベースからデータを取得するModel Context Protocol (MCP) サーバです。このMCPサーバにより、大規模言語モデル (LLMs) は、大量の指標データの検索と分析、指標の使用状況の検索、複雑なクエリの実行などのツール関数を呼び出して実行することができます。

🚀 クイックスタート

MCPサーバを実行するには、Pythonの仮想環境 (venv) が必要です。すべてのパッケージはこのvenvにインストールする必要があり、そうすることでMCPサーバが自動的に起動できます。

Smitheryを通じたインストール

Smithery を通じてClaude Desktop用のPrometheus MCP Serverを自動インストールするには、以下のコマンドを実行します。

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環境に合わせて更新を準備しています。 Cursor設定でこのMCPサーバの位置を以下のように設定します。

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サーバが正しく動作することを確認する方法の1つでもあります。

独立して実行する場合

python3 src/prometheus_mcp_server/server.py

🤝 貢献

このプロジェクトに貢献したい場合は、こちら を訪問して、PRまたはIssueを提出してください。

📄 ライセンス

[ここにライセンス情報を記載]

📚 参考資料

• Prometheus公式ドキュメント
• MCPプロトコル