-
securityA
license-
qualityMCP Server simplifies the implementation of the Model Context Protocol by providing a user-friendly API to create custom tools and manage server workflows efficiently.
Last updated -
2
4
MIT License
Provides ESXi and vCenter Server integration for complete virtual machine lifecycle management (create, clone, delete, power operations), real-time performance monitoring (CPU, memory, storage, network), and server management through a RESTful API interface.
Supports YAML as a configuration format for defining server settings, connection parameters, and authentication details.
ESXi MCP Server
A VMware ESXi/vCenter management server based on MCP (Model Control Protocol), providing simple REST API interfaces for virtual machine management.
Features
Support for ESXi and vCenter Server connections
Real-time communication based on SSE (Server-Sent Events)
RESTful API interface with JSON-RPC support
API key authentication
Complete virtual machine lifecycle management
Real-time performance monitoring
SSL/TLS secure connection support
Flexible configuration options (YAML/JSON/Environment Variables)
Core Functions
Virtual Machine Management
Create VM
Clone VM
Delete VM
Power On/Off operations
List all VMs
Performance Monitoring
CPU usage
Memory usage
Storage usage
Network traffic statistics
Requirements
Python 3.7+
pyVmomi
PyYAML
uvicorn
mcp-core (Machine Control Protocol core library)
Quick Start
Install dependencies:
pip install pyvmomi pyyaml uvicorn mcp-core
Create configuration file
config.yaml:
vcenter_host: "your-vcenter-ip"
vcenter_user: "administrator@vsphere.local"
vcenter_password: "your-password"
datacenter: "your-datacenter" # Optional
cluster: "your-cluster" # Optional
datastore: "your-datastore" # Optional
network: "VM Network" # Optional
insecure: true # Skip SSL certificate verification
api_key: "your-api-key" # API access key
log_file: "./logs/vmware_mcp.log" # Log file path
log_level: "INFO" # Log level
Run the server:
python server.py -c config.yaml
API Interface
Authentication
All privileged operations require authentication first:
POST /sse/messages
Authorization: Bearer your-api-key
Main Tool Interfaces
Create VM
{
"name": "vm-name",
"cpu": 2,
"memory": 4096,
"datastore": "datastore-name",
"network": "network-name"
}
Clone VM
{
"template_name": "source-vm",
"new_name": "new-vm-name"
}
Delete VM
{
"name": "vm-name"
}
Power Operations
{
"name": "vm-name"
}
Resource Monitoring Interface
Get VM performance data:
GET vmstats://{vm_name}
Configuration
Parameter | Description | Required | Default |
vcenter_host | vCenter/ESXi server address | Yes | - |
vcenter_user | Login username | Yes | - |
vcenter_password | Login password | Yes | - |
datacenter | Datacenter name | No | Auto-select first |
cluster | Cluster name | No | Auto-select first |
datastore | Storage name | No | Auto-select largest available |
network | Network name | No | VM Network |
insecure | Skip SSL verification | No | false |
api_key | API access key | No | - |
log_file | Log file path | No | Console output |
log_level | Log level | No | INFO |
Environment Variables
All configuration items support environment variable settings, following these naming rules:
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
Security Recommendations
Production Environment:
Use valid SSL certificates
Enable API key authentication
Set appropriate log levels
Restrict API access scope
Testing Environment:
Set insecure: true to skip SSL verification
Use more detailed log level (DEBUG)
License
MIT License
Contributing
Issues and Pull Requests are welcome!
Changelog
v0.0.1
Initial release
Basic VM management functionality
SSE communication support
API key authentication
Performance monitoring
Author
Bright8192
Acknowledgments
VMware pyvmomi team
MCP Protocol development team
Related MCP Servers
- -securityAlicense-qualityMCP Server provides a simpler API to interact with the Model Context Protocol by allowing users to define custom tools and services to streamline workflows and processes.Last updated -173MIT License
- -securityFlicense-qualityA simple MCP server that allows accessing and executing shell commands on a VM machine through a web-based terminal interface, with automatic tunneling to make the VM accessible from anywhere.Last updated -2455
- -securityAlicense-qualityAn enhanced Python-based MCP server that enables complete VM lifecycle management and monitoring of Proxmox virtualization platforms through natural language, with 11 REST API endpoints for seamless integration.Last updated -26MIT License