Bright8192 Esxi MCP Server

🚀 ESXi MCP Server Manager

A VMware ESXi/vCenter management server based on MCP (Model Control Protocol), providing simple REST API interfaces for virtual machine management.

🚀 Quick Start

Prerequisites

• Python 3.7+
• pyVmomi
• PyYAML
• uvicorn
• mcp-core (Machine Control Protocol core library)

Steps

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: "your-network"             # Optional
guest_os: "your-guest-os"           # Optional

3. Run the server:

python your_script.py

✨ Features

• Support for connecting to ESXi and vCenter Server
• 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
• Support for SSL/TLS secure connections
• Flexible configuration options (YAML/JSON/Environment variables)

💻 Core Functions

Virtual Machine Management

• Create a VM
• Clone a VM
• Delete a VM
• Power on/off operations
• List all VMs

Performance Monitoring

• CPU usage
• Memory usage
• Storage usage
• Network traffic statistics

📚 Documentation

API Interfaces

Authentication

All API requests require a valid authentication token.

Main Interfaces

• Create a VM

POST /vm
{
    "name": "vm-name",
    "guest_os": "ubuntu",
    "network": "vlan1",
    "storage": "/path/to/storage"
}

• Clone a VM

POST /vm/clone
{
    "source_vm": "vm-source",
    "target_name": "vm-target"
}

Configuration

Parameter Description

Environment Variables

All configuration parameters can also be set via environment variables:

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

Security Recommendations

Production Environment

• Use strong passwords.
• Enable SSL certificate verification.
• Configure firewalls to restrict access.

Test Environment

• Do not expose to the public network.
• Use test certificates.
• Regularly clean up virtual machines.

📄 License

[Project license information]

🤝 Contribution Guidelines

[Contribution guidelines information]

📝 Change Log

Version 1.0.0

• Initial version released

Acknowledgments

• VMware Technology Team
• MCP Protocol Development Team