giuliolibrando/vmware-vsphere-mcp-server

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

Infrastructure Management

Monitoring & Performance

Snapshot Management

Template Management

Advanced Monitoring

Reporting & Analytics

Automation

Destructive Operations (Require Confirmation)

Destructive operations require explicit confirmation by setting confirm=True

Security Features

Confirmation System

All destructive operations require explicit confirmation:

# First call - shows warning
delete_vm(vm_id="MyServer", confirm=False)
# Returns: DESTRUCTIVE OPERATION: Delete VM MyServer...

# Second call - executes operation
delete_vm(vm_id="MyServer", confirm=True)
# Returns:  VM MyServer deleted successfully

Environment-Based Authentication

• Credentials stored in environment variables
• No hardcoded passwords
• Secure Docker deployment
• SSL/TLS support with configurable verification

Usage Examples

Basic VM Operations

# List all VMs
"Show me all virtual machines"

# Get VM details
"Get details for VM WebServer01"

# Power operations
"Power on the VM DatabaseServer"
"Restart all VMs: WebServer01, WebServer02, WebServer03"

Monitoring and Reporting

# Performance monitoring
"Show me CPU and memory usage for all VMs"
"Which VMs have high resource usage?"

# Storage monitoring
"Show me datastore usage"
"Which VMs have disk usage over 90%?"

# Comprehensive reporting
"Generate a complete report of the vSphere environment"
"Show me resource utilization summary"

Snapshot Management

# Create snapshots
"Create a snapshot of VM WebServer01 before updates"

# List snapshots
"Show me all snapshots for VM DatabaseServer"

# Delete snapshots (requires confirmation)
"Delete snapshot 'backup-2024-01-15' from VM WebServer01"

Destructive Operations (with confirmation)

# VM deletion (requires confirmation)
"Delete VM TestServer"  # Shows warning
"Delete VM TestServer with confirmation"  # Executes deletion

# Resource modification (requires confirmation)
"Modify VM WebServer01 to have 8 CPUs and 16GB RAM"
"Modify VM WebServer01 to have 8 CPUs and 16GB RAM with confirmation"

# Bulk operations (requires confirmation)
"Delete VMs: OldServer1, OldServer2, OldServer3"
"Delete VMs: OldServer1, OldServer2, OldServer3 with confirmation"