MCP 服务器

A VMware ESXi/vCenter management server

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

README

ESXi MCP 服务器

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

功能特性

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

核心功能

虚拟机管理
- 创建虚拟机
- 克隆虚拟机
- 删除虚拟机
- 电源开启/关闭操作
- 列出所有虚拟机
性能监控
- CPU 使用率
- 内存使用率
- 存储使用率
- 网络流量统计

环境要求

Python 3.7+
pyVmomi
PyYAML
uvicorn
mcp-core (机器控制协议核心库)

快速开始

安装依赖:

pip install pyvmomi pyyaml uvicorn mcp-core

创建配置文件 config.yaml:

vcenter_host: "你的-vcenter-ip"
vcenter_user: "administrator@vsphere.local"
vcenter_password: "你的-密码"
datacenter: "你的-数据中心"        # 可选
cluster: "你的-集群"              # 可选
datastore: "你的-数据存储"          # 可选
network: "VM Network"                # 可选
insecure: true                       # 跳过 SSL 证书验证
api_key: "你的-api-密钥"             # API 访问密钥
log_file: "./logs/vmware_mcp.log"   # 日志文件路径
log_level: "INFO"                    # 日志级别

运行服务器:

python server.py -c config.yaml

API 接口

认证

所有特权操作都需要先进行身份验证：

POST /sse/messages
Authorization: Bearer 你的-api-密钥

主要工具接口

创建虚拟机

{
    "name": "虚拟机-名称",
    "cpu": 2,
    "memory": 4096,
    "datastore": "数据存储-名称",
    "network": "网络-名称"
}

克隆虚拟机

{
    "template_name": "源-虚拟机",
    "new_name": "新-虚拟机-名称"
}

删除虚拟机

{
    "name": "虚拟机-名称"
}

电源操作

{
    "name": "虚拟机-名称"
}

资源监控接口

获取虚拟机性能数据:

GET vmstats://{vm_name}

配置

参数	描述	是否必须	默认值
vcenter_host	vCenter/ESXi 服务器地址	是	-
vcenter_user	登录用户名	是	-
vcenter_password	登录密码	是	-
datacenter	数据中心名称	否	自动选择第一个
cluster	集群名称	否	自动选择第一个
datastore	存储名称	否	自动选择最大的可用存储
network	网络名称	否	VM Network
insecure	跳过 SSL 验证	否	false
api_key	API 访问密钥	否	-
log_file	日志文件路径	否	控制台输出
log_level	日志级别	否	INFO