Bright8192 Esxi MCP Server

🚀 ESXi MCP 服務器管理器

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: "your-network"             # 可選
guest_os: "your-guest-os"           # 可選

3. 運行服務器：

python your_script.py

✨ 主要特性

• 支持連接到 ESXi 和 vCenter Server
• 基於 SSE（服務器發送事件）的即時通信
• 帶有 JSON - RPC 支持的 RESTful API 接口
• API 密鑰認證
• 完整的虛擬機生命週期管理
• 即時性能監控
• SSL/TLS 安全連接支持
• 靈活的配置選項（YAML/JSON/環境變量）

📦 安裝指南

需求

• Python 3.7+
• pyVmomi
• PyYAML
• uvicorn
• mcp - core（機器控制協議核心庫）

💻 使用示例

基礎用法

創建 VM

POST /vm
{
    "name": "vm-name",
    "guest_os": "ubuntu",
    "network": "vlan1",
    "storage": "/path/to/storage"
}

克隆 VM

POST /vm/clone
{
    "source_vm": "vm-source",
    "target_name": "vm-target"
}

📚 詳細文檔

核心功能

虛擬機管理

• 創建 VM
• 克隆 VM
• 刪除 VM
• 開啟/關閉電源操作
• 列出所有 VM

性能監控

• CPU 使用率
• 內存使用率
• 存儲使用率
• 網絡流量統計

API 接口

認證

所有 API 請求都需要提供有效的認證令牌。

主要接口

• 創建 VM：通過發送 POST 請求到 /vm 接口，並在請求體中提供虛擬機的相關信息，如名稱、操作系統、網絡和存儲路徑等。
• 克隆 VM：通過發送 POST 請求到 /vm/clone 接口，並在請求體中指定源虛擬機和目標虛擬機的名稱。

配置

參數說明

環境變量

所有配置參數也可以通過環境變量設置：

• VCENTER_HOST
• VCENTER_USER
• VCENTER_PASSWORD
• DATACENTER
• CLUSTER
• DATASTORE
• NETWORK

安全建議

生產環境

• 使用強密碼
• 啟用 SSL 證書驗證
• 配置防火牆限制訪問

測試環境

• 禁止暴露到公網
• 使用測試證書
• 定期清理虛擬機

📄 許可證

[項目許可證信息]

🤝 貢獻指南

[貢獻指南信息]

📝 變更日誌

版本 1.0.0

• 初始版本發佈

鳴謝

• VMware 技術團隊
• MCP 協議開發團隊