Prometheus MCPサーバー：AIアシスタントとPrometheusのシームレス接続、多ツール対応MCPプロトコルサーバー

Prometheus MCP

Prometheus MCP Serverは、AIアシスタントとPrometheus監視システムをシームレスに接続するプロトコルサーバーで、自然言語による監視指標の照会、分析、発見をサポートし、複数の開発ツールクライアントと互換性があります。

監視開発者ツール #監視統合 #AIアシスタント #自然言語 #軽量サービス .TypeScript

スコア : 2.5ポイント

ダウンロード数 : 8.5K

更新時間 : 2025-07-31

サイトを開く

Prometheus MCP Serverとは？

Prometheus MCP Serverはミドルウェアで、AIアシスタント（VS Code Copilot、Cursor AIなど）が直接Prometheus監視システムと対話できるようにします。自然言語の指示を使用して、複雑なPromQLクエリを記述することなく、指標を照会し、データを分析できます。

Prometheus MCP Serverの使い方は？

AIクライアントの設定にMCPサーバーの設定を追加し、Prometheusのアドレスを指定するだけです。インストール後、「CPU使用率を表示」や「本番環境とテスト環境のエラー率を比較」などの自然言語で監視データを照会できます。

適用シナリオ

開発者や運用担当者が監視指標を迅速に照会し、システムのパフォーマンスを分析し、問題をトラブルシューティングするシナリオに適しています。特に、頻繁に監視システムと対話する必要があるが、複雑なクエリ構文を覚えたくないユーザーに最適です。

主要機能

指標発見

Prometheus内のすべての利用可能な指標とラベルを閲覧および探索します。

自然言語クエリ

簡単な英語で監視データを照会し、PromQLを記述する必要はありません。

傾向分析

時間範囲内の指標の変化傾向と比較を取得します。

複数クライアントサポート

VS Code、Cursor、Windsurf、Claude Desktopなどの複数のAIクライアントをサポートします。

利点

PromQLを学ぶことなく監視データを照会できます。

応答が速く、直接Prometheus APIと統合されています。

設定が簡単で、数分で設定を完了できます。

複数の人気のAIクライアントをサポートしています。

制限

Prometheusサーバーへのネットワークアクセス権が必要です。

複雑なクエリは手動でPromQLを記述する必要がある場合があります。

大量のデータを照会すると、Prometheusのパフォーマンスに影響を与える可能性があります。

使い方

MCPサーバーのインストール

npmまたはDockerを使用してPrometheus MCPサーバーをインストールします。

クライアントの設定

AIクライアントにMCPサーバーの設定を追加します。

照会の開始

AIチャット画面に自然言語の照会指示を入力します。

使用例

基本的な指標照会

現在のシステムのCPU使用率を照会します。

傾向分析

APIの応答時間の変化傾向を分析します。

環境比較

異なる環境のエラー率を比較します。

よくある質問

どのバージョンのNode.jsが必要ですか？

Prometheusへのアクセスをどのように保護しますか？

なぜ一部の照会が空の結果を返すのですか？

🚀 Prometheus MCP Server

このPrometheus MCPサーバーは、AIアシスタントとPrometheusをシームレスに統合し、モニタリングインフラストラクチャとの自然言語対話を可能にします。Visual Studio Code、Cursor、Windsurf、Claude DesktopなどのMCPクライアントを通じて、メトリクスのクエリ、探索、分析を簡単に行うことができます。

✨ 主な機能

高速かつ軽量：Prometheusと直接API統合するため、複雑なパースは必要ありません。
LLMに適した構成：AIアシスタントが消費しやすいように最適化された構造化JSONレスポンス。
設定可能な機能：セキュリティと運用要件に基づいて、ツールカテゴリを有効または無効にできます。
双方向トランスポートサポート：stdioとHTTPの両方のトランスポートで動作し、最大限の互換性を実現します。

📦 インストール

必要条件

Node.js 20.19.0以上
Prometheusサーバーへのアクセス
VS Code、Cursor、Windsurf、Claude Desktopまたはその他のMCPクライアント

インストール手順

まず、クライアントでPrometheus MCPサーバーをインストールします。典型的な設定は次のようになります。

{
  "mcpServers": {
    "prometheus": {
      "command": "npx",
      "args": ["prometheus-mcp@latest", "stdio"],
      "env": {
        "PROMETHEUS_URL": "http://localhost:9090"
      }
    }
  }
}

VS Codeでのインストール

# For VS Code
code --add-mcp '{"name":"prometheus","command":"npx","args":["prometheus-mcp@latest","stdio"],"env":{"PROMETHEUS_URL":"http://localhost:9090"}}'

# For VS Code Insiders
code-insiders --add-mcp '{"name":"prometheus","command":"npx","args":["prometheus-mcp@latest","stdio"],"env":{"PROMETHEUS_URL":"http://localhost:9090"}}'

インストール後、Prometheus MCPサーバーはVS Code内のGitHub Copilotエージェントで使用できます。

Cursorでのインストール

Cursor Settings → MCP → Add new MCP Serverに移動します。好きな名前を付け、commandタイプでnpx prometheus-mcpを使用します。また、Editをクリックして設定を確認またはコマンド引数を追加することもできます。

{
  "mcpServers": {
    "prometheus": {
      "command": "npx",
      "args": ["prometheus-mcp@latest", "stdio"],
      "env": {
        "PROMETHEUS_URL": "http://localhost:9090"
      }
    }
  }
}

Windsurfでのインストール

Windsurf MCPのドキュメントに従ってください。次の設定を使用します。

{
  "mcpServers": {
    "prometheus": {
      "command": "npx",
      "args": ["prometheus-mcp@latest", "stdio"],
      "env": {
        "PROMETHEUS_URL": "http://localhost:9090"
      }
    }
  }
}

Claude Desktopでのインストール

Claude Desktopは2つのインストール方法をサポートしています。

オプション1: DXT拡張機能を使用する

最も簡単なインストール方法は、事前にビルドされたDXT拡張機能を使用することです。

リリースページから最新の.dxtファイルをダウンロードします。
ダウンロードしたファイルをダブルクリックして自動的にインストールします。
拡張機能の設定でPrometheus URLを構成します。

オプション2: 開発者設定を使用する

上級ユーザーまたはカスタム設定の場合は、MCPサーバーを手動で構成します。

Claude Desktopの設定を開きます。
Developerセクションに移動します。
次のMCPサーバー設定を追加します。

{
  "mcpServers": {
    "prometheus": {
      "command": "npx",
      "args": ["prometheus-mcp@latest", "stdio"],
      "env": {
        "PROMETHEUS_URL": "http://localhost:9090"
      }
    }
  }
}

📚 詳細ドキュメント

設定

Prometheus MCPサーバーは、次の引数をサポートしています。これらは、上記のJSON設定の"args"リストの一部として提供できます。

> npx prometheus-mcp@latest --help

Commands:
  stdio  Start Prometheus MCP server using stdio transport
  http   Start Prometheus MCP server using HTTP transport

Options:
  --help     Show help                          [boolean]
  --version  Show version number                [boolean]

環境変数

環境変数を使用してサーバーを構成することもできます。

PROMETHEUS_URL - PrometheusサーバーのURL
ENABLE_DISCOVERY_TOOLS - 探索ツールを無効にするには"false"に設定します（デフォルト: true）
ENABLE_INFO_TOOLS - 情報ツールを無効にするには"false"に設定します（デフォルト: true）
ENABLE_QUERY_TOOLS - クエリツールを無効にするには"false"に設定します（デフォルト: true）

スタンドアロンMCPサーバー

サーバー環境で実行する場合、またはHTTPトランスポートが必要な場合、httpコマンドでMCPサーバーを実行します。

npx prometheus-mcp@latest http --port 3000

そして、MCPクライアントの設定でurlをHTTPエンドポイントに設定します。

{
  "mcpServers": {
    "prometheus": {
      "command": "npx",
      "args": ["mcp-remote", "http://localhost:3000/mcp"]
    }
  }
}

Dockerを使用した実行

Dockerを使用してPrometheus MCPサーバーを実行するには、次の設定を使用します。

{
  "mcpServers": {
    "prometheus": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--init",
        "--pull=always",
        "-e",
        "PROMETHEUS_URL=http://host.docker.internal:9090",
        "ghcr.io/idanfishman/prometheus-mcp",
        "stdio"
      ]
    }
  }
}

ツール

Prometheus MCPサーバーは、3つの設定可能なカテゴリに分けられた10個のツールを提供します。

探索

Prometheusインフラストラクチャを探索するためのツールです。

prometheus_list_metrics
- 説明: 利用可能なすべてのPrometheusメトリクスをリストします。
- パラメータ: なし
- 読み取り専用: true
prometheus_metric_metadata
- 説明: 特定のPrometheusメトリクスのメタデータを取得します。
- パラメータ:
  - metric (文字列): メタデータを取得するメトリクス名
- 読み取り専用: true
prometheus_list_labels
- 説明: 利用可能なすべてのPrometheusラベルをリストします。
- パラメータ: なし
- 読み取り専用: true
prometheus_label_values
- 説明: 特定のPrometheusラベルのすべての値を取得します。
- パラメータ:
  - label (文字列): 値を取得するラベル名
- 読み取り専用: true
prometheus_list_targets
- 説明: すべてのPrometheusスクレイプターゲットをリストします。
- パラメータ: なし
- 読み取り専用: true
prometheus_scrape_pool_targets
- 説明: 特定のスクレイププールのターゲットを取得します。
- パラメータ:
  - scrapePool (文字列): スクレイププール名
- 読み取り専用: true

情報

Prometheusサーバーの情報にアクセスするためのツールです。

prometheus_runtime_info
- 説明: Prometheusのランタイム情報を取得します。
- パラメータ: なし
- 読み取り専用: true
prometheus_build_info
- 説明: Prometheusのビルド情報を取得します。
- パラメータ: なし
- 読み取り専用: true

クエリ

Prometheusクエリを実行するためのツールです。

prometheus_query
- 説明: 即時のPrometheusクエリを実行します。
- パラメータ:
  - query (文字列): Prometheusクエリ式
  - time (文字列、オプション): クエリの時間パラメータ（RFC3339形式）
- 読み取り専用: true
prometheus_query_range
- 説明: Prometheusの範囲クエリを実行します。
- パラメータ:
  - query (文字列): Prometheusクエリ式
  - start (文字列): 開始タイムスタンプ（RFC3339またはUNIXタイムスタンプ）
  - end (文字列): 終了タイムスタンプ（RFC3339またはUNIXタイムスタンプ）
  - step (文字列): クエリの解像度ステップ幅
- 読み取り専用: true