Un servidor de administración VMware ESXi/vCenter

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)

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

Instalar dependencias:

pip install pyvmomi pyyaml uvicorn mcp-core

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

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

Crear máquina virtual

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

Clonar máquina virtual

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

Eliminar máquina virtual

{
    "name": "vm-name"
}

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

Parámetro	Descripción	Requerido	Por defecto
vcenter_host	Dirección del servidor vCenter/ESXi	Sí	-
vcenter_user	Nombre de usuario de inicio de sesión	Sí	-
contraseña de vcenter	Contraseña de inicio de sesión	Sí	-
centro de datos	Nombre del centro de datos	No	Seleccionar automáticamente primero
grupo	Nombre del clúster	No	Seleccionar automáticamente primero
almacén de datos	Nombre de almacenamiento	No	Seleccionar automáticamente el más grande disponible
red	Nombre de la red	No	Red de máquinas virtuales
inseguro	Omitir la verificación SSL	No	FALSO
clave api	Clave de acceso a la API	No	-
archivo de registro	Ruta del archivo de registro	No	Salida de consola
nivel de registro	Nivel de registro	No	INFORMACIÓ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

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

A VMware ESXi/vCenter management server

Integrations