Loglmhq MCP Server Prometheus

🚀 mcp-server-prometheus

このプロジェクトは、Prometheusのメトリクスとデータを操作するためのMCPサーバーです。TypeScriptをベースに構築され、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を提供します。

⚙️ 設定

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

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

オプションの認証設定：

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

💻 開発

依存関係のインストール

npm install

サーバーのビルド

npm run build

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

npm run watch

📚 ドキュメント

API構造

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

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

各メトリクスリソースはJSONデータを返し、以下の内容を含みます。

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