mcp-server-prometheus

mcp-server-prometheus

Prometheus のメトリクスやデータを操作するための MCP サーバーです。

Prometheus API インターフェースを実装した、TypeScript ベースの MCP サーバーです。Model Context Protocol（MCP）を通じて、Claude と Prometheus サーバーを橋渡しします。

デモ

機能

リソース

• Prometheus のメトリクススキーマを一覧表示し、アクセスできます
• 各メトリクスリソースには、以下の情報が含まれます：
  • メトリクス名と説明
  • Prometheus から取得した詳細なメタデータ
  • 統計情報（count、min、max）
• 構造化データにアクセスするための JSON MIME タイプ

現在の機能

• 利用可能なすべての Prometheus メトリクスを説明付きで一覧表示します
• 以下を含む詳細なメトリクス情報を読み取ります：
  • メタデータとヘルプテキスト
  • 現在の統計データ（count、min、max の値）
• 認証が必要な Prometheus インスタンスのための基本認証に対応しています

設定

サーバーには以下の環境変数が必要です：

• PROMETHEUS_URL：Prometheus インスタンスのベース URL

認証のオプション設定：

• PROMETHEUS_USERNAME：基本認証用のユーザー名（必要な場合）
• PROMETHEUS_PASSWORD：基本認証用のパスワード（必要な場合）

開発

依存関係をインストールします：

npm install

サーバーをビルドします：

npm run build

自動再ビルドを使用した開発の場合：

npm run watch

インストール

Claude Desktop で使用するには、サーバー設定を追加します：

MacOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server-prometheus": {
      "command": "/path/to/mcp-server-prometheus/build/index.js",
      "env": {
        "PROMETHEUS_URL": "http://your-prometheus-instance:9090"
      }
    }
  }
}

デバッグ

MCP サーバーは標準入出力（stdio）を介して通信するため、デバッグが難しい場合があります。MCP Inspector の使用をおすすめします：

npm run inspector

Inspector により、ブラウザーでデバッグツールにアクセスするための URL が表示されます。

API 構造

サーバーは、以下の URI 構造で Prometheus メトリクスを公開します：

• ベース URI：http://your-prometheus-instance:9090
• メトリクス URI：http://your-prometheus-instance:9090/metrics/{metric_name}

各メトリクスリソースは、以下を含む JSON データを返します：

• メトリクス名
• メタデータ（ヘルプテキスト、タイプ）
• 現在の統計情報（count、min、max）