Servidor ESXi MCP

Un servidor de administración VMware ESXi/vCenter basado en MCP (Protocolo de control de modelos) que proporciona interfaces API REST simples para la administración de máquinas virtuales.

Características

• Compatibilidad con conexiones de ESXi y vCenter Server

• Comunicación en tiempo real basada en SSE (eventos enviados por el servidor)

• Interfaz API RESTful con soporte JSON-RPC

• Autenticación de clave API

• Gestión completa del ciclo de vida de las máquinas virtuales

• Monitoreo del rendimiento en tiempo real

• Compatibilidad con conexión segura SSL/TLS

• Opciones de configuración flexibles (YAML/JSON/Variables de entorno)

Related MCP server: vSphere MCP Server

Funciones principales

• Gestión de máquinas virtuales

  • Crear máquina virtual

  • Clonar máquina virtual

  • Eliminar máquina virtual

  • Operaciones de encendido y apagado

  • Listar todas las máquinas virtuales

• Monitoreo del rendimiento

  • Uso de la CPU

  • Uso de memoria

  • Uso del almacenamiento

  • Estadísticas de tráfico de red

Requisitos

• Python 3.7+

• pyVmomi

• PyYAML

• uvicornio

• mcp-core (biblioteca principal del Protocolo de Control de Máquina)

Inicio rápido

1. Instalar dependencias:

pip install pyvmomi pyyaml uvicorn mcp-core

2. Crear el archivo de configuración 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

3. Ejecutar el servidor:

python server.py -c config.yaml

Interfaz API

Autenticación

Todas las operaciones privilegiadas requieren autenticación primero:

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

Interfaces de herramientas principales

1. Crear máquina virtual

{
    "name": "vm-name",
    "cpu": 2,
    "memory": 4096,
    "datastore": "datastore-name",
    "network": "network-name"
}

2. Clonar máquina virtual

{
    "template_name": "source-vm",
    "new_name": "new-vm-name"
}

3. Eliminar máquina virtual

{
    "name": "vm-name"
}

4. Operaciones de energía

{
    "name": "vm-name"
}

Interfaz de monitoreo de recursos

Obtener datos de rendimiento de la máquina virtual:

GET vmstats://{vm_name}

Configuración

Variables de entorno

Todos los elementos de configuración admiten configuraciones de variables de entorno, siguiendo estas reglas de nomenclatura:

• Host de VCENTER

• USUARIO DE VCENTER

• CONTRASEÑA DE VCENTER

• VCENTER_DATACENTER

• CLUSTER_VCENTER

• ALMACÉN DE DATOS DE VCENTER

• RED_VCENTER

• VCENTER_INSECURE

• CLAVE DE API MCP

• ARCHIVO DE REGISTRO MCP

• NIVEL DE REGISTRO MCP

Recomendaciones de seguridad

1. Entorno de producción:

   • Utilice certificados SSL válidos

   • Habilitar la autenticación de clave API

   • Establecer niveles de registro apropiados

   • Restringir el alcance del acceso a la API

2. Entorno de prueba:

   • Establezca inseguro: verdadero para omitir la verificación SSL

   • Utilice un nivel de registro más detallado (DEBUG)

Licencia

Licencia MIT

Contribuyendo

¡Los problemas y las solicitudes de extracción son bienvenidos!

Registro de cambios

versión 0.0.1

• Lanzamiento inicial

• Funcionalidad básica de gestión de máquinas virtuales

• Soporte de comunicación de SSE

• Autenticación de clave API

• Monitoreo del rendimiento

Autor

Bright8192

Expresiones de gratitud

• Equipo de VMware pyvmomi

• Equipo de desarrollo del protocolo MCP