vSphere MCP Server

A comprehensive Model Context Protocol (MCP) server for VMware vSphere management, providing AI agents with full access to virtual infrastructure operations through a secure, Dockerized environment.

Features

Core VM Management

• List VMs - Get all virtual machines with power states
• VM Details - Detailed information about specific VMs
• Power Operations - Start, stop, restart VMs
• Resource Monitoring - CPU, RAM, and network utilization
• Storage Information - Disk usage and datastore details

Advanced Operations

• Snapshot Management - Create, list, and delete VM snapshots
• Template Management - List and manage VM templates
• Bulk Operations - Power operations on multiple VMs
• Resource Modification - Change CPU and memory allocation
• Network Management - Port groups and network configuration

Monitoring & Reporting

• Performance Monitoring - Real-time resource utilization
• Event Logging - VM events and system logs
• Alarm Management - Active alarms and alerts
• Comprehensive Reports - Environment-wide analytics
• Resource Utilization - CPU, memory, and storage summaries

Safety Features

• Confirmation System - All destructive operations require explicit confirmation
• Error Handling - Comprehensive error messages and troubleshooting
• Secure Authentication - Environment-based credential management
• Audit Trail - Clear logging of all operations

Installation

Prerequisites

• Docker and Docker Compose
• VMware vCenter Server with REST API access
• Valid vCenter credentials

Quick Start

1. Clone repo

2. Configure Environment

cp env.example .env
# Edit .env with your vCenter credentials

3. Deploy with Docker

docker compose up -d

Configuration

Environment Variables

Create a .env file with the following variables:

# vCenter Connection
VCENTER_HOST=vcenter.domain.local
VCENTER_USER=username@domain.local
VCENTER_PASSWORD=your_password_here
INSECURE=True

# Server Configuration
SERVER_HOST=0.0.0.0
SERVER_PORT=8000

AnythingLLM Integration

Add the following configuration to your anythingllm_mcp_servers.json:

{
  "mcpServers": {
    "vsphere-mcp-server": {
      "name": "vSphere MCP Server",
      "type": "streamable",
      "url": "http://vsphere-mcp-server:8000/mcp",
      "auth_token": null,
      "enabled": true
    }
  }
}

Available Tools

VM Management

Tool	Description	Parameters
list_vms	List all virtual machines	hostname (optional)
get_vm_details	Get detailed VM information	vm_id, hostname (optional)
power_on_vm	Power on a virtual machine	vm_id, hostname (optional)
power_off_vm	Power off a virtual machine	vm_id, hostname (optional)
restart_vm	Restart a virtual machine	vm_id, hostname (optional)

Infrastructure Management

Tool	Description	Parameters
list_hosts	List all ESXi hosts	hostname (optional)
list_datastores	List all datastores	hostname (optional)
list_networks	List all networks	hostname (optional)
list_datacenters	List all datacenters	hostname (optional)

Monitoring & Performance

Tool	Description	Parameters
get_vm_performance_info	Get VM performance metrics	hostname (optional)
get_host_performance_info	Get host performance metrics	hostname (optional)
get_vm_disk_usage	Get VM disk utilization	hostname (optional)
get_datastore_usage	Get datastore utilization	hostname (optional)
get_vms_with_high_resource_usage	Find VMs with high resource allocation	hostname (optional)

Snapshot Management

Tool	Description	Parameters
list_vm_snapshots	List

... View full README on GitHub