prometheus-mcp-server

prometheus-mcp-server

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

これは Prometheus API インターフェースを実装した TypeScript ベースの MCP サーバーです。Model Context Protocol（MCP）を通じて、Claude とお使いの Prometheus サーバーをつなぎます。

機能

• 即時クエリ：指定した時刻に PromQL クエリを実行します
• 範囲クエリ：一定期間にわたって PromQL クエリを実行します
• 系列の検出：ラベルマッチャーで系列を検索します
• ラベルの探索：ラベル名と値を取得します
• メタデータへのアクセス：メトリクスのメタデータを取得します
• ターゲット情報：スクレイプターゲットの情報を取得します
• アラートとルール：アラートと記録ルールの情報を取得します
• ステータス情報：Prometheus サーバーのステータス情報を取得します

インストール

# Install globally
npm install -g prometheus-mcp-server

# Or install locally
npm install prometheus-mcp-server

# Or use npx to run without installation
npx prometheus-mcp-server

Claude での使用方法

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

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

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

npx での使用

Claude Desktop の設定で npx を使用することもできます。

{
  "mcpServers": {
    "prometheus-mcp-server": {
      "command": "npx prometheus-mcp-server",
      "env": {
        "PROMETHEUS_BASE_URL": "http://your-prometheus-instance:9090"
      }
    }
  }
}

設定

デフォルトでは、クライアントは http://localhost:9090 で実行されている Prometheus サーバーに接続します。PROMETHEUS_BASE_URL 環境変数を設定すると、Prometheus サーバーの URL を指定できます。

# Example: Connect to a different Prometheus server
PROMETHEUS_BASE_URL=http://my-prometheus-server:9090 prometheus-mcp-server

これにより、ソースコードを変更せずに、任意の Prometheus インスタンスをクライアントの接続先として指定できます。

利用可能な関数

サーバーでは、以下の関数を利用できます。

• mcp__instant_query：即時 PromQL クエリを実行します
• mcp__range_query：一定期間にわたって範囲 PromQL クエリを実行します
• mcp__get_series：ラベルマッチャーで系列を検索します
• mcp__get_label_values：指定したラベルの値を取得します
• mcp__get_metadata：メトリクスのメタデータを取得します
• mcp__get_targets：スクレイプターゲットの情報を取得します
• mcp__get_alerts：アラートの情報を取得します
• mcp__get_rules：記録ルールとアラートルールの情報を取得します
• mcp__get_status：Prometheus サーバーのステータス情報を取得します

開発

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

# Debug
npm run dev:debug

デバッグ

MCP サーバーは標準入出力（stdio）で通信するため、デバッグが難しい場合があります。デバッグには、以下の npm スクリプトを使用できます。

# Inspect mode
npm run inspect

# Inspect with breakpoints
npm run inspect-debug

ライセンス

ISC

コントリビューション

コントリビューションを歓迎します。お気軽にプルリクエストを送信してください。