ESXi MCP サーバー

MCP (Model Control Protocol) に基づく VMware ESXi/vCenter 管理サーバー。仮想マシン管理用のシンプルな REST API インターフェイスを提供します。

特徴

• ESXi および vCenter Server 接続のサポート

• SSE（Server-Sent Events）に基づくリアルタイム通信

• JSON-RPC をサポートする RESTful API インターフェース

• APIキー認証

• 完全な仮想マシンライフサイクル管理

• リアルタイムパフォーマンス監視

• SSL/TLS セキュア接続のサポート

• 柔軟な構成オプション（YAML/JSON/環境変数）

Related MCP server: MCP Server

コア機能

• 仮想マシン管理

  • VMの作成

  • VMのクローン

  • VMの削除

  • 電源オン/オフ操作

  • すべてのVMを一覧表示する

• パフォーマンス監視

  • CPU使用率

  • メモリ使用量

  • ストレージ使用量

  • ネットワークトラフィック統計

要件

• Python 3.7以上

• pyVmomi

• パイヤム

• ウビコーン

• mcp-core (マシン制御プロトコル コア ライブラリ)

クイックスタート

1. 依存関係をインストールします:

pip install pyvmomi pyyaml uvicorn mcp-core

2. 設定ファイルconfig.yamlを作成します。

vcenter_host: "your-vcenter-ip"
vcenter_user: "administrator@vsphere.local"
vcenter_password: "your-password"
datacenter: "your-datacenter"        # Optional
cluster: "your-cluster"              # Optional
datastore: "your-datastore"          # Optional
network: "VM Network"                # Optional
insecure: true                       # Skip SSL certificate verification
api_key: "your-api-key"             # API access key
log_file: "./logs/vmware_mcp.log"   # Log file path
log_level: "INFO"                    # Log level

3. サーバーを実行します。

python server.py -c config.yaml

APIインターフェース

認証

すべての特権操作にはまず認証が必要です。

POST /sse/messages
Authorization: Bearer your-api-key

メインツールインターフェース

1. VMの作成

{
    "name": "vm-name",
    "cpu": 2,
    "memory": 4096,
    "datastore": "datastore-name",
    "network": "network-name"
}

2. VMのクローン

{
    "template_name": "source-vm",
    "new_name": "new-vm-name"
}

3. VMの削除

{
    "name": "vm-name"
}

4. 電力事業

{
    "name": "vm-name"
}

リソース監視インターフェース

VM のパフォーマンス データを取得します。

GET vmstats://{vm_name}

構成

環境変数

すべての構成項目は、次の命名規則に従って環境変数設定をサポートします。

• VCENTER_HOST

• VCENTER_ユーザー

• VCENTER_パスワード

• VCENTER_データセンター

• VCENTER_クラスター

• VCENTER_データストア

• VCENTER_NETWORK

• VCENTER_INSECURE

• MCP_API_KEY

• MCP_ログ_ファイル

• MCP_ログ_レベル

セキュリティに関する推奨事項

1. 生産環境:

   • 有効なSSL証明書を使用する

   • APIキー認証を有効にする

   • 適切なログレベルを設定する

   • APIアクセス範囲を制限する

2. テスト環境:

   • SSL検証をスキップするには、insecure: trueを設定します。

   • より詳細なログレベル（DEBUG）を使用する

ライセンス

MITライセンス

貢献

問題やプルリクエストを歓迎します!

変更履歴

バージョン0.0.1

• 初回リリース

• 基本的なVM管理機能

• SSE通信サポート

• APIキー認証

• パフォーマンス監視

著者

ブライト8192

謝辞

• VMware pyvmomi チーム

• MCPプロトコル開発チーム