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 协议开发团队