ESXi MCP 服务器管理器

基于 MCP（模型控制协议）的 VMware ESXi/vCenter 管理服务器，提供简单的 REST API 接口用于虚拟机管理。

特性

• 支持连接到 ESXi 和 vCenter Server
• 基于 SSE（服务器发送事件）的实时通信
• 带有 JSON-RPC 支持的 RESTful API 接口
• API 密钥认证
• 完整的虚拟机生命周期管理
• 实时性能监控
• SSL/TLS 安全连接支持
• 灵活的配置选项（YAML/JSON/环境变量）

核心功能

虚拟机管理

• 创建 VM
• 克隆 VM
• 删除 VM
• 开启/关闭电源操作
• 列出所有 VM

性能监控

• CPU 使用率
• 内存使用率
• 存储使用率
• 网络流量统计

需求

• Python 3.7+
• pyVmomi
• PyYAML
• uvicorn
• 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"        # 可选
cluster: "your-cluster"              # 可选
datastore: "your-datastore"          # 可选
network: "your-network"             # 可选
guest_os: "your-guest-os"           # 可选

3. 运行服务器：

python your_script.py

API 接口

认证

所有 API 请求都需要提供有效的认证令牌。

主要接口

• 创建 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"
  }
  

配置

参数说明

环境变量

所有配置参数也可以通过环境变量设置：

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

安全建议

生产环境

• 使用强密码
• 启用 SSL 证书验证
• 配置防火墙限制访问

测试环境

• 禁止暴露到公网
• 使用测试证书
• 定期清理虚拟机

许可证

[项目许可证信息]

贡献指南

[贡献指南信息]

变更日志

版本 1.0.0

• 初始版本发布

鸣谢：

• VMware 技术团队
• MCP 协议开发团队