ESXi MCP Server

What is ESXi MCP Server?

A VMware ESXi/vCenter management server based on MCP (Model Control Protocol), providing REST API interfaces for virtual machine management. It is designed for VMware administrators and developers who need programmatic VM lifecycle control and real-time performance monitoring.

How to use ESXi MCP Server?

Install dependencies (pyvmomi, pyyaml, uvicorn, mcp-core), create a YAML configuration file with vCenter credentials and API key, then run python server.py -c config.yaml. Access the API with POST /sse/messages using an Authorization: Bearer your-api-key header.

Key features of ESXi MCP Server

• Supports ESXi and vCenter Server connections
• Real-time SSE (Server-Sent Events) communication
• RESTful API interface with JSON-RPC support
• API key authentication for privileged operations
• Complete virtual machine lifecycle management
• Real-time performance monitoring (CPU, memory, storage, network)

Use cases of ESXi MCP Server

• Create, clone, and delete virtual machines programmatically
• Power on/off VMs via API
• Monitor VM CPU, memory, storage, and network usage in real time
• Automate VM management tasks in CI/CD pipelines
• Manage VMs across distributed vCenter environments

FAQ from ESXi MCP Server

What protocol does ESXi MCP Server use for communication?

It uses Server-Sent Events (SSE) for real-time communication between the server and client.

How do I authenticate API requests?

All privileged operations require an API key sent as a Bearer token in the Authorization header (e.g., Authorization: Bearer your-api-key).

What are the runtime requirements?

Python 3.7 or higher and the following Python packages: pyVmomi, PyYAML, uvicorn, and mcp-core.

Can I configure the server without a YAML file?

Yes, all configuration parameters can be set via environment variables (e.g., VCENTER_HOST, VCENTER_USER, MCP_API_KEY).

What performance data can I retrieve for a VM?

You can obtain CPU usage, memory usage, storage usage, and network traffic statistics by accessing the vmstats:// URI of a VM.