convez.ai
MCP ServerDevOps & InfraestruturaAvançado
bright8192

ESXi MCP Server

bright8192/esxi-mcp-server

Gerenciador de VMs VMware via MCP com APIs REST e monitoramento em tempo real

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP para gerenciamento de VMware ESXi e vCenter, oferecendo interfaces REST API simples para operações com máquinas virtuais. Suporta ciclo de vida completo de VMs, monitoramento de performance em tempo real e autenticação por chave de API.

Instalação

$npx convez-ai bright8192/esxi-mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
65
Forks
28
Acompanhando
3
Saúde
42%
Último commit
há 1 ano
Versão
—
Issues abertas
6
Contribuidores
1

Casos de uso

  • Automação de provisionamento e clonagem de máquinas virtuais
  • Monitoramento de performance de VMs (CPU, memória, storage, rede)
  • Integração de ambientes vCenter/ESXi com fluxos de IA e automação
  • Controle centralizado de operações de potência (ligar/desligar) em VMs

Veredito

Ferramenta robusta e bem estruturada para integrar gerenciamento VMware em workflows MCP. Requer conhecimento técnico de vCenter/ESXi, mas oferece abstração clara via REST API e suporta segurança adequada (SSL, API keys). Pronto para produção com devidas configurações de segurança.

README

A tradução para o português deste README ainda está na fila.

ESXi MCP Server

A VMware ESXi/vCenter management server based on MCP (Model Control Protocol), providing simple REST API interfaces for virtual machine management.

Features

  • Support for ESXi and vCenter Server connections
  • Real-time communication based on SSE (Server-Sent Events)
  • RESTful API interface with JSON-RPC support
  • API key authentication
  • Complete virtual machine lifecycle management
  • Real-time performance monitoring
  • SSL/TLS secure connection support
  • Flexible configuration options (YAML/JSON/Environment Variables)

Core Functions

  • Virtual Machine Management
    • Create VM
    • Clone VM
    • Delete VM
    • Power On/Off operations
    • List all VMs
  • Performance Monitoring
    • CPU usage
    • Memory usage
    • Storage usage
    • Network traffic statistics

Requirements

  • Python 3.7+
  • pyVmomi
  • PyYAML
  • uvicorn
  • mcp-core (Machine Control Protocol core library)

Quick Start

  1. Install dependencies:
pip install pyvmomi pyyaml uvicorn mcp-core
  1. Create configuration file config.yaml:
vcenter_host: "your-vcenter-ip"
vcenter_user: "administrator@vsphere.local"
vcenter_password: "your-password"
datacenter: "your-datacenter"        # Optional
cluster: "your-cluster"              # Optional
datastore: "your-datastore"          # Optional
network: "VM Network"                # Optional
insecure: true                       # Skip SSL certificate verification
api_key: "your-api-key"             # API access key
log_file: "./logs/vmware_mcp.log"   # Log file path
log_level: "INFO"                    # Log level
  1. Run the server:
python server.py -c config.yaml

API Interface

Authentication

All privileged operations require authentication first:

POST /sse/messages
Authorization: Bearer your-api-key

Main Tool Interfaces

  1. Create VM
{
    "name": "vm-name",
    "cpu": 2,
    "memory": 4096,
    "datastore": "datastore-name",
    "network": "network-name"
}
  1. Clone VM
{
    "template_name": "source-vm",
    "new_name": "new-vm-name"
}
  1. Delete VM
{
    "name": "vm-name"
}
  1. Power Operations
{
    "name": "vm-name"
}

Resource Monitoring Interface

Get VM performance data:

GET vmstats://{vm_name}

Configuration

ParameterDescriptionRequiredDefault
vcenter_hostvCenter/ESXi server addressYes-
vcenter_userLogin usernameYes-
vcenter_passwordLogin passwordYes-
datacenterDatacenter nameNoAuto-select first
clusterCluster nameNoAuto-select first
datastoreStorage nameNoAuto-select largest available
networkNetwork nameNoVM Network
insecureSkip SSL verificationNofalse
api_keyAPI access keyNo-
log_fileLog file pathNoConsole output
log_levelLog levelNoINFO

Environment Variables

All configuration items support environment variable settings, following these naming rules:

  • VCENTER_HOST
  • VCENTER_USER
  • VCENTER_PASSWORD
  • VCENTER_DATACENTER
  • VCENTER_CLUSTER
  • VCENTER_DATASTORE
  • VCENTER_NETWORK
  • VCENTER_INSECURE
  • MCP_API_KEY
  • MCP_LOG_FILE
  • MCP_LOG_LEVEL

Security Recommendations

  1. Production Environment:

    • Use valid SSL certificates
    • Enable API key authentication
    • Set appropriate log levels
    • Restrict API access scope
  2. Testing Environment:

    • Set insecure: true to skip SSL verification
    • Use more detailed log level (DEBUG)

License

MIT License

Contributing

Issues and Pull Requests are welcome!

Changelog

v0.0.1

  • Initial release
  • Basic VM management functionality
  • SSE communication support
  • API key authentication
  • Performance monitoring

Author

Bright8192

Acknowledgments

  • VMware pyvmomi team
  • MCP Protocol development team
Ver o original no GitHub

Bom para

Relacionados