Esxi MCP Server

🚀 ESXi MCP サーバーマネージャー

このプロジェクトは、MCP（モデル制御プロトコル）に基づくVMware ESXi/vCenter管理サーバーです。シンプルなREST APIインターフェースを提供し、仮想マシンの管理を行います。

🚀 クイックスタート

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"        # オプション
cluster: "your-cluster"              # オプション
datastore: "your-datastore"          # オプション
network: "VM Network"                # オプション
insecure: true                       # SSL証明書の検証を無視する
api_key: "your-api-key"             # APIアクセスキー
log_file: "./logs/vmware_mcp.log"   # ログファイルのパス
log_level: "INFO"                    # ログレベル

3. サーバーを起動します：

python server.py -c config.yaml

✨ 主な機能

• ESXiとvCenter Serverへの接続をサポート
• SSE（サーバー送信イベント）に基づくリアルタイム通信
• RESTful APIインターフェースで、JSON-RPCをサポート
• APIキー認証
• 完全な仮想マシンのライフサイクル管理
• リアルタイムのパフォーマンス監視
• SSL/TLSセキュア接続のサポート
• 柔軟な設定オプション（YAML/JSON/環境変数）

仮想マシン管理

• VMの作成
• VMのクローン
• VMの削除
• 起動/シャットダウン操作
• すべてのVMの一覧表示

パフォーマンス監視

• CPU使用率
• メモリ使用率
• ストレージ使用率
• ネットワークトラフィック統計

📦 インストール

必要条件

• Python 3.7+
• pyVmomi
• PyYAML
• uvicorn
• mcp-core（マシン制御プロトコルのコアライブラリ）

💻 使用例

基本的な使用法

認証

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

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

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

1. VMの作成

{
    "name": "vm-name",
    "cpu": 2,
    "memory": 4096,
    "datastore": "データストア名",
    "network": "ネットワーク名"
}

2. VMのクローン

{
    "template_name": "ソースVM名",
    "new_name": "新しいVM名"
}

3. VMの削除

{
    "name": "vm-name"
}

4. 電源操作

{
    "name": "vm-name"
}

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

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

GET vmstats://{vm_name}

📚 ドキュメント

設定

環境変数

すべての設定項目は、環境変数で設定することもできます。以下の命名規則に従います：

• VCENTER_HOST
• VCENTER_USER
• VCENTER_PASSWORD
• VCENTER_DATACENTER
• VCENTER_CLUSTER
• VCENTER_DATASTORE
• VCENTER_NETWORK
• VCENTER_INSECURE
• MCP_API_KEY
• MCP_LOG_FILE
• MCP_LOG_LEVEL

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

1. 本番環境：

   • 有効なSSL証明書を使用する
   • APIキー認証を有効にする
   • 適切なログレベルを設定する
   • APIのアクセス範囲を制限する

2. テスト環境：

   • insecure: trueを設定して、SSL検証をスキップする
   • より詳細なログレベル（DEBUG）を使用する

📄 ライセンス

MITライセンス

貢献

問題の報告やプルリクエストは大歓迎です！

変更履歴

v0.1

• 初期バージョンのリリース

知的財産権声明

本プロジェクトはMITライセンスに準拠しており、詳細はLICENSEファイルを参照してください。

⚠️ 重要な注意事項

このドキュメントはソースコードから直接生成されたものではなく、元の内容に基づいて再作成されています。引用する場合は、公式ドキュメントまたはソースコードを参照してください。