vsphere-mcp-server
Provides tools for managing and monitoring VMware vSphere infrastructure, including virtual machines, hosts, datacenters, datastores, networks, and folders.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@vsphere-mcp-server List all virtual machines on my vCenter server."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
vSphere MCP Server
MCP server for VMware vSphere infrastructure management. Provides comprehensive access to vSphere environments through the Model Context Protocol.
Features
Seamless Authentication: Domain-based credential caching with GUI prompts
VM Management: List, inspect, and control virtual machines
Infrastructure Monitoring: Monitor hosts, datacenters, and datastores
Network Discovery: Explore networks and extract VLAN information
Organization Tools: Navigate folders and organizational structures
Secure Credential Storage: macOS Keychain integration with TTL
Related MCP server: vsphere-mcp
Installation
From PyPI (Recommended)
pip install vsphere-mcp-serverFrom Source
# Clone the repository
git clone https://github.com/rorymcmahon/vsphere-mcp-server.git
cd vsphere-mcp-server
# Install dependencies
pip install -r requirements.txt
# Install in development mode
pip install -e .Configuration
Add to your MCP client configuration:
{
"mcpServers": {
"vsphere": {
"command": "python",
"args": ["-m", "vsphere_mcp_server.server"]
}
}
}Available Tools
Authentication
vsphere_clear_credentials(hostname)- Clear cached credentials for domain
Virtual Machine Management
list_vms(hostname)- List all VMs with basic infoget_vm_details(hostname, vm_id)- Detailed VM configurationpower_on_vm(hostname, vm_id)- Power on VMpower_off_vm(hostname, vm_id)- Power off VM
Infrastructure Management
list_hosts(hostname)- List ESXi hostsget_host_details(hostname, host_id)- Host detailslist_datacenters(hostname)- List datacentersget_datacenter_details(hostname, datacenter_id)- Datacenter detailslist_datastores(hostname)- List datastores with capacityget_datastore_details(hostname, datastore_id)- Datastore details
Organization
list_folders(hostname, folder_type)- List folders by typeget_folder_details(hostname, folder_id)- Folder details
Networking
list_networks(hostname)- List networks with VLAN infoget_network_details(hostname, network_id)- Network detailslist_vlans(hostname)- Extract VLAN info from network names
Usage Examples
Basic VM Operations
# List all virtual machines
list_vms("vcenter.domain.local")
# Get detailed VM information
get_vm_details("vcenter.domain.local", "vm-123")
# Power operations
power_on_vm("vcenter.domain.local", "vm-123")
power_off_vm("vcenter.domain.local", "vm-123")Infrastructure Monitoring
# Check datastore capacity
list_datastores("vcenter.domain.local")
# Monitor host status
list_hosts("vcenter.domain.local")
get_host_details("vcenter.domain.local", "host-456")Network Discovery
# Explore network configuration
list_networks("vcenter.domain.local")
# Extract VLAN information
list_vlans("vcenter.domain.local")Credential Management
# Clear stored credentials if needed
vsphere_clear_credentials("vcenter.domain.local")Authentication
The server uses domain-based credential caching:
First Use: GUI prompts for username and password
Credential Storage: Stored in macOS Keychain with 4-hour TTL
Automatic Renewal: Re-prompts when credentials expire
Domain Extraction:
vcenter.domain.local→domain.local
Supported Username Formats
username@domain.localdomain\username(converted to @ format)username(domain auto-appended)
Security
Credentials stored securely in macOS Keychain
4-hour TTL prevents stale credential usage
SSL verification disabled by default (common in enterprise environments)
Session tokens used for API authentication
Automatic session cleanup on exit
Error Handling
The server provides clear error messages with troubleshooting steps:
Authentication Errors: Suggests clearing credentials
Connection Errors: Indicates network/hostname issues
API Errors: Shows specific vSphere API responses
Development
# Install development dependencies
pip install -e ".[dev]"
# Run tests
pytest
# Format code
black src/ tests/
isort src/ tests/
# Type checking
mypy src/Troubleshooting
Authentication Issues
Clear credentials:
vsphere_clear_credentials("hostname")Verify username format includes domain
Check network connectivity to vCenter
Connection Issues
Verify hostname is reachable
Check vCenter is running and accessible
Confirm SSL/TLS configuration
Permission Issues
Verify user has required vSphere permissions
Check role assignments in vCenter
Ensure user can access required objects
License
MIT License - see LICENSE file for details.
Available Tools
17 toolsget_datacenter_detailsB
Get detailed information about a datacenter.
Args: hostname: vSphere hostname (e.g., vcenter.domain.local) datacenter_id: Datacenter ID
Inputs: hostname (required), datacenter_id (required). Returns: result
get_datastore_detailsC
Get detailed information about a datastore.
Args: hostname: vSphere hostname (e.g., vcenter.domain.local) datastore_id: Datastore ID
Inputs: hostname (required), datastore_id (required). Returns: result
get_folder_detailsA
Get detailed information about a folder.
Args: hostname: vSphere hostname (e.g., vcenter.domain.local) folder_id: Folder ID
Inputs: hostname (required), folder_id (required). Returns: result
get_host_detailsB
Get detailed information about an ESXi host.
Args: hostname: vSphere hostname (e.g., vcenter.domain.local) host_id: ESXi host ID
Inputs: host_id (required), hostname (required). Returns: result
get_network_detailsB
Get detailed information about a network.
Args: hostname: vSphere hostname (e.g., vcenter.domain.local) network_id: Network ID
Inputs: hostname (required), network_id (required). Returns: result
get_vlan_infoA
Get information about a VLAN by name or VLAN ID.
Args: hostname: vSphere hostname (e.g., vcenter.domain.local) vlan_query: VLAN name (e.g., v1306-MEL03-Secure-Management) or VLAN ID (e.g., 1306)
Inputs: hostname (required), vlan_query (required). Returns: result
get_vm_detailsA
Get detailed information about a specific virtual machine.
Args: hostname: vSphere hostname (e.g., vcenter.domain.local) vm_id: Virtual machine ID or name
Inputs: vm_id (required), hostname (required). Returns: result
list_datacentersB
List all datacenters.
Args: hostname: vSphere hostname (e.g., vcenter.domain.local)
Inputs: hostname (required). Returns: result
list_datastoresB
List all datastores with capacity information.
Args: hostname: vSphere hostname (e.g., vcenter.domain.local)
Inputs: hostname (required). Returns: result
list_foldersA
List folders by type.
Args: hostname: vSphere hostname (e.g., vcenter.domain.local) folder_type: Folder type (VIRTUAL_MACHINE, HOST, DATACENTER, DATASTORE, NETWORK)
Inputs: hostname (required), folder_type. Returns: result
list_hostsA
List all ESXi hosts.
Args: hostname: vSphere hostname (e.g., vcenter.domain.local)
Inputs: hostname (required). Returns: result
list_networksA
List all networks with VLAN information.
Args: hostname: vSphere hostname (e.g., vcenter.domain.local)
Inputs: hostname (required). Returns: result
list_vlansB
Extract and list VLAN information from network names.
Args: hostname: vSphere hostname (e.g., vcenter.domain.local)
Inputs: hostname (required). Returns: result
list_vmsA
List all virtual machines with basic information.
Args: hostname: vSphere hostname (e.g., vcenter.domain.local)
Inputs: hostname (required). Returns: result
power_off_vmC
Power off a virtual machine.
Args: hostname: vSphere hostname (e.g., vcenter.domain.local) vm_id: Virtual machine ID
Inputs: vm_id (required), hostname (required). Returns: result
power_on_vmA
Power on a virtual machine.
Args: hostname: vSphere hostname (e.g., vcenter.domain.local) vm_id: Virtual machine ID
Inputs: vm_id (required), hostname (required). Returns: result
vsphere_clear_credentialsB
Clear stored vSphere credentials for a domain.
Args: hostname: vSphere hostname (e.g., vcenter.domain.local)
Inputs: hostname (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 17 tools
Each tool targets a specific entity type and action (list vs get details vs power). There is no overlap; every tool has a clear, distinct purpose.
Most tools follow a consistent 'list_<entity>' and 'get_<entity>_details' pattern. Minor deviations: 'get_vlan_info' instead of 'get_vlan_details', and 'vsphere_clear_credentials' uses a different verb prefix.
17 tools is well-scoped for a vSphere management server, covering the main entities and basic actions without being overwhelming or too sparse.
The set covers listing and getting details for core entities, plus power control for VMs. However, it lacks create/update/delete operations and more advanced VM actions (clone, snapshot, etc.), leaving notable gaps for full lifecycle management.
Maintenance
Related MCP Connectors
MCP server for Support & Service Management
MCP server for Product Management
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA VMware ESXi/vCenter management server based on MCP (Machine Control Protocol), providing simple REST API interfaces for virtual machine management.65MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for VMware vSphere/vCenter operations, enabling natural language control of VMs, hosts, and infrastructure.Apache 2.0
- FlicenseNot gradedqualityCmaintenanceA comprehensive MCP server for VMware vSphere management, enabling AI agents to perform VM operations, monitoring, snapshots, and reporting through a secure, Dockerized environment.27-
- AlicenseAqualityAmaintenanceMCP server for managing VMware vCenter (vSphere 7/8) with 39 tools covering VMs, clusters, and ESXi hosts. Supports direct and jump host deployment modes.20MIT