ESXi MCP 服务器管理器

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

功能

• 支持 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（机器控制协议核心库）

快速开始

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

API 接口

认证

所有特权操作都需要先进行认证：

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 License

贡献

欢迎提出问题和拉取请求！

变更记录

v0.1

• 初始版本发布

知识产权声明

本项目遵守 MIT 许可证，具体内容请参考 LICENSE 文件。

注意：此文档是根据原始内容重新编写的，并未直接从源代码生成。如需引用，请参考官方文档或源代码。