Skip to main content
Glama

vSphere MCP Server

Python 3.10+ License: MIT PyPI version Pylint Safety Security Scan Dependency Security Check

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

pip install vsphere-mcp-server

From 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 info

  • get_vm_details(hostname, vm_id) - Detailed VM configuration

  • power_on_vm(hostname, vm_id) - Power on VM

  • power_off_vm(hostname, vm_id) - Power off VM

Infrastructure Management

  • list_hosts(hostname) - List ESXi hosts

  • get_host_details(hostname, host_id) - Host details

  • list_datacenters(hostname) - List datacenters

  • get_datacenter_details(hostname, datacenter_id) - Datacenter details

  • list_datastores(hostname) - List datastores with capacity

  • get_datastore_details(hostname, datastore_id) - Datastore details

Organization

  • list_folders(hostname, folder_type) - List folders by type

  • get_folder_details(hostname, folder_id) - Folder details

Networking

  • list_networks(hostname) - List networks with VLAN info

  • get_network_details(hostname, network_id) - Network details

  • list_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:

  1. First Use: GUI prompts for username and password

  2. Credential Storage: Stored in macOS Keychain with 4-hour TTL

  3. Automatic Renewal: Re-prompts when credentials expire

  4. Domain Extraction: vcenter.domain.local → domain.local

Supported Username Formats

  • username@domain.local

  • domain\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

  1. Clear credentials: vsphere_clear_credentials("hostname")

  2. Verify username format includes domain

  3. Check network connectivity to vCenter

Connection Issues

  1. Verify hostname is reachable

  2. Check vCenter is running and accessible

  3. Confirm SSL/TLS configuration

Permission Issues

  1. Verify user has required vSphere permissions

  2. Check role assignments in vCenter

  3. Ensure user can access required objects

License

MIT License - see LICENSE file for details.

Available Tools

17 tools
get_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

    A3.5/5.0

    Scored across 17 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    17 tools is well-scoped for a vSphere management server, covering the main entities and basic actions without being overwhelming or too sparse.

    Completeness3/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for VMware vSphere/vCenter operations, enabling natural language control of VMs, hosts, and infrastructure.
      Apache 2.0
    • F
      license
      Not graded
      quality
      C
      maintenance
      A comprehensive MCP server for VMware vSphere management, enabling AI agents to perform VM operations, monitoring, snapshots, and reporting through a secure, Dockerized environment.
      27
      -