Prometheus MCP Server

🚀 Prometheus MCP サーバー

このサーバーは、Prometheus 用の Model Context Protocol (MCP) サーバーです。標準化された MCP インターフェースを通じて、Prometheus のメトリクスとクエリにアクセスでき、AI アシスタントが PromQL クエリを実行してメトリクスデータを分析できるようになります。

✨ 主な機能

• [x] Prometheus への PromQL クエリの実行
• [x] メトリクスの発見と探索
  • [x] 利用可能なメトリクスの一覧表示
  • [x] 特定のメトリクスのメタデータの取得
  • [x] 即時クエリ結果の表示
  • [x] 範囲クエリ結果と異なるステップ間隔の表示
• [x] 認証のサポート
  • [x] 環境変数からの基本認証の使用
  • [x] 環境変数からのベアラートークン認証の使用
• [x] Docker コンテナ化のサポート
• [x] AI アシスタント用の対話型ツールの提供

ツールリストは設定可能です。これにより、MCP クライアントに提供するツールを選択でき、特定の機能を使用しない場合やコンテキストウィンドウをあまり使用したくない場合に便利です。

📦 インストール

1. この MCP サーバーを実行する環境から、Prometheus サーバーにアクセスできることを確認してください。
2. .env ファイルまたはシステム環境変数を使用して、Prometheus サーバーの情報を取得するための環境変数を設定します。

# 必須：Prometheus 設定
PROMETHEUS_URL=http://your-prometheus-server:9090

# オプション：認証情報（必要な場合）
# 必要に応じて、以下の認証方法の 1 つを選択してください。

# 基本認証の場合
BASIC_AUTH_USERNAME=your_username
BASIC_AUTH_PASSWORD=your_password

# ベアラートークン認証の場合
BEARER_TOKEN=your_bearer_token

# その他のオプション設定
ScrapeInterval=60  # 間隔（秒）
ScrapeTimeout=10    # スクレイピングタイムアウト（秒）

3. サーバーをインストールして実行します。

uv install
uv run

📚 ドキュメント

プロジェクト構造

このプロジェクトは src ディレクトリ構造で組織されています。

prometheus-mcp-server/
├── src/
│   └── prometheus_mcp_server/
│       ├── __init__.py      # パッケージ初期化ファイル
│       ├── server.py        # MCP サーバーの実装
│       └── main.py          # メインアプリケーションロジック
├── Dockerfile               # Docker 構成ファイル
├── docker-compose.yml       # Docker Compose 構成ファイル
├── .dockerignore            # Docker 無視ファイル
└── README.md                # このファイル

テスト

このプロジェクトには包括的なテストスイートが含まれており、機能を確保し、回帰を防止するのに役立ちます。

テストを実行するには、以下のコマンドを実行します。

# 開発依存関係のインストール
uv pip install -e ".[dev]"

# テストの実行
pytest

# カバレッジレポートの生成
pytest --cov=src --cov-report=term-missing

ツール

📄 ライセンス

MIT