MCP Server Prometheus

🚀 mcp-server-prometheus

このMCPサーバーは、Prometheusのメトリクスとデータとのやり取りを可能にします。TypeScriptベースのMCPサーバーで、Prometheus APIインターフェースを実装しています。モデルコンテキストプロトコル（MCP）を通じて、ClaudeとPrometheusサーバーの間に橋渡しを提供します。

🚀 クイックスタート

このサーバーを使用することで、ClaudeとPrometheusサーバーの間でデータをやり取りできるようになります。以下の手順に従って、サーバーをセットアップしてください。

✨ 主な機能

リソース

• Prometheusメトリクスモードを一覧表示し、アクセスできます。
• 各メトリクスリソースは以下を提供します：
  • メトリクス名と説明
  • Prometheusからの詳細なメタデータ
  • 統計情報（カウント、最小値、最大値）
• 構造化データアクセスのためにJSON MIMEタイプをサポートします。

現在の機能

• 利用可能なすべてのPrometheusメトリクスとその説明を一覧表示します。
• 詳細なメトリクス情報を読み取ります。これには以下が含まれます：
  • メタデータとヘルプテキスト
  • 現在の統計データ（カウント値、最小値、最大値）
• 保護されたPrometheusインスタンスに対する基本認証をサポートします。

📦 インストール

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サーバーは標準入出力を通じて通信するため、デバッグは難しい場合があります。MCP Inspectorの使用をおすすめします。

npm run inspector

Inspectorは、ブラウザでアクセスできるデバッグツールのURLを提供します。

💻 使用例

基本的な使用法

サーバーを開発するための基本的な手順を示します。

依存関係のインストール

npm install

サーバーのビルド

npm run build

自動再構築を使用した開発

npm run watch

📚 ドキュメント

設定

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

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

オプションの認証設定：

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

API構造

サーバーは以下のURI構造を通じてPrometheusメトリクスを公開します。

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

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

• メトリクス名
• メタデータ（ヘルプテキスト、タイプ）
• 現在の統計情報（カウント、最小値、最大値）

演示