Prometheus

🚀 Prometheus MCP サーバー

このサーバーは、Prometheusデータベースからデータを取得するためのモデルコンテキストプロトコル（MCP）サーバーです。このMCPサーバーにより、大規模言語モデル（LLMs）は、大量の指標データの検索、指標の使用状況の検索、複雑なクエリの実行などのツール関数を呼び出して実行することができ、事前定義されたルートを通じて使用の強化制御を実現します。

• データ検索：Prometheusから特定の指標または期間内のデータを取得します。
• 指標分析：検索された指標に対して統計分析を行います。
• 使用状況検索：指標の使用パターンを検索および探索します。
• 複雑なクエリ：高度なPromQLクエリを実行して、データの詳細な探索を行います。

✨ 主な機能

✅ Prometheus内の包括的な指標情報（名前と説明を含む）を取得します。 ✅ 指標名を通じて特定の指標データを取得し、分析します。 ✅ カスタム時間範囲内で指標データを分析します。 🚧 特定のラベルを使用してデータをフィルタリングおよびマッチングする（開発中） ⏳ さらに多くの機能を追加する予定です...

🚀 クイックスタート

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

💻 使用例

Cursor Envと一緒に使用する

使いやすいCursor環境に合わせて更新する準備ができています。 Cursor設定のMCPセクションで以下のように設定します：

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

MCPクライアント（Claude Desktopを含む）との使用

Claude Desktopアプリケーションの設定ファイル（macOSの場合：~/Library/Application Support/Claude/claude_desktop_config.json）を以下のように設定します：

{
    "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）。

📚 ドキュメント

詳細情報については、プロジェクトのURLをご覧ください：https://github.com/yourusername/prometheus-mcp-server

このドキュメントでは、Prometheus MCPサーバーの機能、インストール方法、使用方法、およびプロジェクトへの貢献方法について説明しています。ご参考になれば幸いです！