hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Enables data retrieval and analysis from Prometheus databases, including fetching specific metrics, performing statistical analysis, searching metric usage patterns, and executing complex PromQL queries for in-depth data exploration.

Prometheus 用 MCP サーバー

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

データ取得: Prometheus から特定のメトリックまたはデータ範囲を取得します。
メトリック分析: 取得したメトリックに対して統計分析を実行します。
使用状況検索: メトリックの使用パターンを見つけて調査します。
複雑なクエリ: 詳細なデータ探索のために高度な PromQL クエリを実行します。

能力

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

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

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

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

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

はじめる

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

貢献

貢献を歓迎します！簡単なガイドはこちらです:

リポジトリをフォークする
機能ブランチを作成します（ git checkout -b feature/AmazingFeature ）
変更をコミットします（ git commit -m 'Add some AmazingFeature' ）
ブランチにプッシュする ( git push origin feature/AmazingFeature )
プルリクエストを開く

大きな変更については、まず問題を開いて、何を変更したいのか話し合ってください。

ご貢献ありがとうございました！

ライセンス

MITライセンス

参考文献と謝辞

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

Prometheus APIクライアント- Prometheus API呼び出しコードはこのライブラリに基づいて変更されています
MySQL MCP Server - 同様のデータベース指向のMCPサーバー実装

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

事前定義されたルートを通じて、大規模言語モデルが Prometheus データベースからメトリックデータを取得、分析、クエリできるようにする MCP サーバー。

Related Resources

Reddit Discussion about this server

Prometheus MCP Server