Esxi MCP Server

🚀 ESXi MCP Server Manager

An MCP (Model Control Protocol)-based VMware ESXi/vCenter management server that offers 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 interfaces supporting JSON-RPC
• API key authentication
• Comprehensive virtual machine lifecycle management
• Real-time performance monitoring
• Support for SSL/TLS secure connections
• Flexible configuration options (YAML/JSON/Environment variables)

✨ Core Features

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

1. Install dependencies:

pip install pyvmomi pyyaml uvicorn mcp-core

2. Create a 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                       # Ignore 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

3. Run the server:

python server.py -c config.yaml

📚 Documentation

Authentication

All privileged operations require prior authentication:

POST /sse/messages
Authorization: Bearer your-api-key

Main Tool Interfaces

1. Create a VM

{
    "name": "vm-name",
    "cpu": 2,
    "memory": 4096,
    "datastore": "Data store name",
    "network": "Network name"
}

2. Clone a VM

{
    "template_name": "Source VM name",
    "new_name": "New VM name"
}

3. Delete a VM

{
    "name": "vm-name"
}

4. Power operations

{
    "name": "vm-name"
}

Resource Monitoring Interface

Get VM performance data:

GET vmstats://{vm_name}

Configuration

Environment Variables

All configuration items support being set via environment variables, 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

💡 Usage Tip

Security Recommendations

1. Production environment:

   • Use valid SSL certificates
   • Enable API key authentication
   • Set appropriate log levels
   • Limit API access scope

2. Test environment:

   • Set insecure: true to skip SSL verification
   • Use a more detailed log level (DEBUG)

📄 License

MIT License

🤝 Contribution

Issues and pull requests are welcome!

📝 Change Log

v0.1

• Initial version released

📜 Intellectual Property Statement

This project adheres to the MIT license. Please refer to the LICENSE file for specific details.

⚠️ Important Note

This documentation is rewritten based on the original content and not directly generated from the source code. Please refer to the official documentation or source code for citations.