Prometheus MCP Server 7t1

🚀 Prometheus MCP サーバー

このサーバーは、Prometheus の指標とデータをやり取りするための Model Context Protocol (MCP) サーバーです。TypeScript ベースの MCP サーバーで、Prometheus の API インターフェースを実装しています。Claude が Model Context Protocol (MCP) を通じて Prometheus サーバーとやり取りできるようにする橋渡しの役割を果たします。

✨ 主な機能

• 即時クエリ：特定の時点で PromQL クエリを実行します。
• 範囲クエリ：一定期間内で PromQL クエリを実行します。
• シリーズ検出：ラベルマッチャーに基づいてシリーズデータを検索します。
• ラベル探索：特定のラベルの値を取得します。
• メタデータアクセス：指標のメタデータを取得します。
• ターゲット情報：収集ターゲットの情報を取得します。
• アラートとルール：アラートと記録ルールの情報を取得します。
• ステータス情報：Prometheus サーバーのステータス情報を取得します。

📦 インストール

# グローバルインストール
npm install -g prometheus-mcp-server

# またはローカルインストール
npm install prometheus-mcp-server

# または npx を使用してインストールせずに実行
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_HOST": "http://your-prometheus-instance:9090"
      }
    }
  }
}

npx を使用する場合

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

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

📚 ドキュメント

設定

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

• PROMETHEUS_HOST：Prometheus インスタンスのベース URL（デフォルトは http://localhost:9090）

利用可能な関数

サーバーは以下の関数を提供します。

• 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 サーバーのステータス情報を取得します。

開発

# 依存関係のインストール
npm install

# プロジェクトのビルド
npm run build

# サーバーの起動
npm start

# デバッグ
npm run dev:debug

デバッグ

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

# 検査モード
npm run inspect

# ブレークポイント付き検査
npm run inspect-debug

📄 ライセンス

ISC

貢献

貢献を歓迎します！自由に Pull Request を送信してください。