MCP Prometheus

🚀 Prometheus MCP Server (Go)

Prometheusとの統合のためのModel Context Protocol (MCP)サーバーです。client-goを介したKubernetes接続機能を備えたネイティブGoバイナリです。

🚀 クイックスタート

このPrometheus MCP Serverは、Prometheusとの統合を容易にするためのサーバーです。以下の手順に従ってインストールと設定を行ってください。

📦 インストール

npx

npx -y mcp-prometheus@latest

MCPクライアント設定

MCPクライアント設定（VS Code、Cursor、Windsurfなど）に追加します。

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

VS Code

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

Kubernetes自動接続

K8S APIサービスプロキシを介して、OpenShift/Kubernetesで実行されているPrometheusに自動的に接続します。client-goを介してネイティブのkubeconfig/クラスタ内設定を使用します。kubectlやポートフォワーディングは必要ありません。 デフォルト: openshift-monitoring/prometheus-operated:9090

{
  "mcpServers": {
    "prometheus": {
      "command": "npx",
      "args": ["-y", "mcp-prometheus@latest"]
    }
  }
}

バイナリ

GitHub Releasesからダウンロードするか、ソースからビルドします。

make build
./mcp-prometheus

📚 ドキュメント

設定

環境変数

CLIフラグ

優先順位: --url / PROMETHEUS_URL > K8S自動接続

接続戦略:

1. 直接のURL（--urlまたはPROMETHEUS_URLが設定されている場合）
2. K8S APIプロキシ（kubeconfigまたはクラスタ内設定を自動検出）

ツール (11)

基本クエリ

クラスタ診断

リソース分析

プロンプトの例

"すべてのノードの現在のCPU使用率はどれくらいですか？"
"クラスタの健全性の概要を表示してください"
"最も多くのメモリを使用しているポッドはどれですか？"
"ノードworker-1を診断してください"
"すべてのスクレイプターゲットは健全ですか？"
"現在と24時間前のCPU使用率を比較してください"
"本番環境のネームスペースのポッドmy-appを調査してください"
"定義されているアラートルールは何ですか？"

開発

ビルド

make build              # 現在のプラットフォーム用にビルド
make build-all-platforms # すべてのプラットフォーム用にクロスコンパイル

コンテナ

podman build -f Containerfile -t mcp-prometheus .

Kubernetes / OpenShiftデプロイメント

コンテナイメージ

コンテナイメージはGitHub Container Registryで利用可能です。

ghcr.io/jeanlopezxyz/mcp-prometheus:latest

Helmチャート

含まれているHelmチャートを使用してデプロイします。

# チャートリポジトリを追加する（またはローカルチャートを使用する）
helm upgrade --install mcp-prometheus ./charts/mcp-prometheus \
  --namespace mcp-servers \
  --create-namespace \
  --set openshift=true

Helm値

カスタムPrometheusの例

helm upgrade --install mcp-prometheus ./charts/mcp-prometheus \
  --namespace mcp-servers \
  --set openshift=true \
  --set prometheus.url=http://prometheus.monitoring:9090

📄 ライセンス

MIT