vcf-ops-mcp

VCF Operations (vROps) の suite-api REST API をラップする MCP サーバーです。リソース、メトリクス、アラートを MCP ツールとして公開し、LLM クライアントが監視対象のインフラストラクチャを直接クエリできるようにします。

セットアップ

python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
cp .env.example .env   # then fill in your VCF Operations details

必須設定 (.env または実際の環境変数で指定):

サーバーは、初回使用時に /suite-api/api/auth/token/acquire からトークンを取得してキャッシュし、有効期限が近づくか 401 で拒否された場合には、自動的に再取得します。

サーバーのトランスポート/認証設定 (こちらも .env または実際の環境変数で指定):

実行

デフォルトでは、streamable-http を使用するスタンドアローンの リモートサーバー として実行され、127.0.0.1:8000 にバインドされ、すべてのリクエストでベアラートークンを要求します:

export VCFOPS_MCP_BEARER_TOKEN="$(openssl rand -hex 32)"
vcf-ops-mcp
# or
python -m vcf_ops_mcp

GET /healthz は認証不要です (ロードバランサー/オーケストレーターの死活監視用)。それ以外のすべてにはベアラートークンが必要です。127.0.0.1 はローカルのみで待ち受けるため、他のホストから実際にアクセスするには VCFOPS_MCP_HOST=0.0.0.0 にバインドするか (またはリバースプロキシの背後で実行)、ベアラートークンがネットワークと、監視環境全体を照会できる資格情報との間の唯一の防壁となるようにしてください。つまり、他のシークレットと同じように扱い、信頼できないネットワーク上での平文 HTTP ではなく、その前段に TLS 終端 (例: リバースプロキシ) を置くことを推奨します。

VCFOPS_MCP_HOST が 127.0.0.1/localhost でない場合、FastMCP 自身の DNS リバインディング保護 (受信リクエストの Host ヘッダーの検査) は、ループバックホストに対してのみ許可リストを自動設定するため、デフォルトでは許可リストが空になります。未設定のままにすると Host ヘッダーのエラーは実行されず、ベアラートークンが唯一の防衛線となります。信頼できるネットワークなら問題ありませんが、共有ネットワークや信頼できないネットワークでは多層防御のため、VCFOPS_MCP_ALLOWED_HOSTS にクライアントが実際に接続するホスト名/IP:ポートをカンマ区切りで設定してください。

MCP クライアントを streamable-http サーバーとして接続します。例: Claude Code の場合:

claude mcp add --transport http vcf-operations http://<host>:8000/mcp \
  --header "Authorization: Bearer <your-token>"

stdio で実行する場合

MCP クライアントがサーバー自体をサブプロセスとして起動するローカルでの利用 (ネットワーク公開が不要) では、VCFOPS_MCP_TRANSPORT=stdio を設定してください — このモードではベアラートークンは不要です。Claude Desktop の設定例:

{
  "mcpServers": {
    "vcf-operations": {
      "command": "/absolute/path/to/.venv/bin/vcf-ops-mcp",
      "env": {
        "VCFOPS_MCP_TRANSPORT": "stdio",
        "VCFOPS_BASE_URL": "https://ops.example.com",
        "VCFOPS_USERNAME": "admin",
        "VCFOPS_PASSWORD": "changeme"
      }
    }
  }
}

ツール

リソース

• list_resources — 監視オブジェクトオブジェクトを名前/アダプタ種別/リソース種別/ヘルスで検索

• get_resource — 1 つのリソースの詳細を取得

• get_resource_properties — 収集された構成プロパティを取得

• get_resource_relationships — 親/子オブジェクトを取得

メトリクス

• list_metric_keys — アダプタ種別/リソース種別のペアで利用可能な statKeys を一覧

• get_latest_stats — リソースの最新のメトリック値を取得

• query_stats — ロールアップ/間隔を指定して、複数リソースにまたがる履歴時系列をクエリ

アラート

• list_alerts — アクテブまたは全アラートを取得。リソースや重要度 Memphisでスコープ指定も可能

• get_alert — 1 つののアラートの詳細を取得

• list_alert_definitions — アラートの背後にあるルール定義を一覧

テスト

pip install -e ".[dev]"
pytest

テストは respx を使用して VCF Operations HTTP API をモックします。実際のインスタンスは不要です。

注記

• mcp<2.0.0 に固定しています: MCP Python SDK の 2.x 系では FastMCP が MCPServer に改名され、mcp.server.mcpserver に移動しました。このプロジェクトは、安定実績のある 1.x の mcp.server.fastmcp.FastMCP API を対象としています。