Prometheus 用 MCP サーバー

Prometheusデータベースからデータを取得するためのモデルコンテキストプロトコル（MCP）サーバー。このMCPサーバーにより、大規模言語モデル（LLM）は、膨大な量のメトリックデータを取得・分析するツール関数の呼び出し、メトリックの使用状況の検索、複雑なクエリの実行、そして使用状況の高度な制御を備えた事前定義されたルートを介したその他の関連タスクの実行が可能になります。

• データ取得: Prometheus から特定のメトリックまたはデータ範囲を取得します。

• メトリック分析: 取得したメトリックに対して統計分析を実行します。

• 使用状況検索: メトリックの使用パターンを見つけて調査します。

• 複雑なクエリ: 詳細なデータ探索のために高度な PromQL クエリを実行します。

能力

✅ Prometheusから名前や説明を含む包括的なメトリック情報を取得します

✅ メトリック名を使用して特定のメトリックデータを取得して分析する

✅ カスタム時間範囲内でメトリックデータを分析する

🚧 特定のラベルを使用してデータをフィルタリングおよび一致させる（開発中）

⏳ 追加機能が計画されています...

Related MCP server: Proms MCP Server

はじめる

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

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Prometheus MCP サーバーを自動的にインストールするには:

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

使用法

カーソル環境あり

より使いやすいカーソル環境に応じて更新する準備が整いました。

カーソル設定の MCP セクションでこれを設定します。

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

MCPクライアント（Claudeデスクトップを含む）

Claude デスクトップ アプリの設定を~/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 サーバー

この MCP サーバーを単独で開始しました:

UV法

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

これは、Claude Desktop がアプリの起動時にこの ux スクリプトを使用して起動するため、この MCP サーバーが自動的に起動できるようにする方法でもあります。

通常の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ライセンス

参考文献と謝辞

このプロジェクトは、次のオープンソース プロジェクトからインスピレーションを得たか、またはそのプロジェクトのコードを使用しています。

• Prometheus APIクライアント- Prometheus API呼び出しコードはこのライブラリに基づいて変更されています

• MySQL MCP Server - 同様のデータベース指向のMCPサーバー実装