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: "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（服務器發送事件）的即時通信。
• 靈活的 API 接口：RESTful API 接口，支持 JSON - RPC。
• 安全的認證機制：API 密鑰認證。
• 全面的生命週期管理：完整的虛擬機生命週期管理。
• 即時性能監控：可即時監控 CPU 使用率、內存使用率、存儲使用率和網絡流量統計等。
• 安全連接保障：支持 SSL/TLS 安全連接。
• 靈活的配置方式：支持 YAML/JSON/環境變量等靈活的配置選項。

📦 安裝指南

本項目的安裝需要滿足以下需求：

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

安裝依賴項的命令如下：

pip install pyvmomi pyyaml uvicorn mcp-core

💻 使用示例

基礎用法

認證

所有特權操作都需要先進行認證：

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

創建 VM

{
    "name": "vm-name",
    "cpu": 2,
    "memory": 4096,
    "datastore": "數據存儲名稱",
    "network": "網絡名稱"
}

克隆 VM

{
    "template_name": "源 VM 名稱",
    "new_name": "新 VM 名稱"
}

刪除 VM

{
    "name": "vm-name"
}

電源操作

{
    "name": "vm-name"
}

獲取 VM 性能數據

GET vmstats://{vm_name}

📚 詳細文檔

配置說明

配置參數詳情

安全建議

⚠️ 重要提示

不同環境下需要注意不同的安全配置。

💡 使用建議

• 生產環境：使用有效的 SSL 證書，啟用 API 密鑰認證，設置適當的日誌級別，限制 API 訪問範圍。
• 測試環境：設置 insecure: true 以跳過 SSL 驗證，使用更詳細的日誌級別（DEBUG）。

📄 許可證

本項目採用 MIT License。

貢獻

歡迎提出問題和拉取請求！

變更記錄

v0.1

• 初始版本發佈

知識產權聲明

本項目遵守 MIT 許可證，具體內容請參考 LICENSE 文件。

注意：此文檔是根據原始內容重新編寫的，並未直接從源代碼生成。如需引用，請參考官方文檔或源代碼。