bright8192_esxi-mcp-server

🚀 ESXi MCP 服务器管理器

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

✨ 主要特性

• 支持连接到 ESXi 和 vCenter Server，实现多平台管理。
• 基于 SSE（服务器发送事件）的实时通信，确保信息及时同步。
• 带有 JSON - RPC 支持的 RESTful API 接口，方便开发者调用。
• API 密钥认证，保障系统安全。
• 完整的虚拟机生命周期管理，覆盖虚拟机的各个阶段。
• 实时性能监控，随时掌握系统运行状态。
• SSL/TLS 安全连接支持，增强数据传输安全性。
• 灵活的配置选项（YAML/JSON/环境变量），满足不同场景需求。

🚀 快速开始

安装依赖项

pip install pyvmomi pyyaml uvicorn mcp-core

创建配置文件 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"           # 可选

运行服务器

python your_script.py

💻 使用示例

虚拟机管理

创建 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 使用率
• 内存使用率
• 存储使用率
• 网络流量统计

需求

• Python 3.7+
• pyVmomi
• PyYAML
• uvicorn
• mcp - core（机器控制协议核心库）

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 服务器地址 | 是 | | | vcenter_user | 用户名 | 是 | | | vcenter_password | 密码 | 是 | | | datacenter | 数据中心名称 | 否 | default | | cluster | 集群名称 | 否 | default | | datastore | 存储位置 | 否 | default | | network | 网络 | 否 | default |

环境变量

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

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

安全建议

生产环境

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

测试环境

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

变更日志

版本 1.0.0

• 初始版本发布

📄 许可证

[项目许可证信息]

🤝 贡献指南

[贡献指南信息]

鸣谢：

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