ProxmoxMCP-Plus
Plataforma de control para Proxmox VE que expone operaciones de máquinas virtuales, contenedores LXC, copias de seguridad y snapshots mediante protocolos MCP y OpenAPI, permitiendo integración con agentes de IA y automatización HTTP segura.
Ficha actualizada 27 sept 2026, 1:15 · upstream 26 sept 2026, 12:33 · release v0.5.23
Qué es ProxmoxMCP-Plus
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
ProxmoxMCP-Plus actúa como plano de control unificado entre clientes de inteligencia artificial (como Claude Desktop o Cursor) y la infraestructura Proxmox VE. Ofrece dos interfaces principales: MCP para flujos de trabajo de agentes y OpenAPI para automatización HTTP estándar, dashboards y herramientas sin código. La arquitectura soporta gestión completa del ciclo de vida de máquinas virtuales y contenedores LXC, incluyendo creación, destrucción, snapshots y restauración desde copias de seguridad.
Incluye capacidades avanzadas como ejecución de comandos SSH en contenedores con guardrails de seguridad, seguimiento de trabajos asíncronos mediante IDs estables y auditoría de historial. La plataforma prioriza la seguridad mediante el uso de tokens de API de Proxmox, autenticación Bearer para OpenAPI, validación TLS y controles estrictos de origen en MCP. Además, ofrece integración opcional con OAuth 2.0 y persistencia de estado en PostgreSQL para entornos multi-nodo o distribuidos.
El proyecto facilita la orquestación de tareas complejas como descargas de ISOs, limpieza de almacenamiento y gestión del clúster sin necesidad de scripts ad-hoc. Soporta tanto despliegues locales vía Python (PyPI) como contenerizados con Docker Compose, adaptándose a necesidades de infraestructura existentes.
- Gestión de máquinas virtuales y contenedores LXC desde agentes de IA
- Automatización de copias de seguridad y restauración de snapshots
- Ejecución de comandos SSH en contenedores con políticas de seguridad
- Monitoreo de estado de nodos, almacenamiento y clúster
- Integración con dashboards HTTP o herramientas sin código vía OpenAPI
- Persistencia de trabajos asíncronos para tareas largas de Proxmox
- Soporte dual nativo para MCP (stdio/HTTP) y OpenAPI
- Seguridad reforzada con tokens API, autenticación Bearer y TLS
- Integración opcional con OAuth 2.0 y PostgreSQL para estado distribuido
- Ejecución de comandos SSH con guardrails y sandboxing
- Persistencia de trabajos asíncronos con IDs estables y auditoría
- Despliegue flexible vía PyPI o contenedores Docker Compose
- Requiere configuración manual de tokens API de Proxmox en el archivo de configuración
- La persistencia de OAuth requiere una instancia externa de PostgreSQL
- El modo Code Mode tiene límites estrictos de memoria y tiempo de ejecución
- Las herramientas MCP pueden filtrarse mediante listas de permitidos o denegados
- No incluye gestión automática de certificados TLS, requiere configuración manual
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Despliegue vía Docker Compose recomendado para entornos distribuidos; usar variables de entorno para credenciales y evitar hardcodeo. Para OAuth, configurar PostgreSQL y validar MCP_OAUTH_DATABASE_URL. En despliegues locales, instalar desde PyPI o usar uvx. Asegurar que los tokens Proxmox tengan permisos mínimos necesarios (principio de menor privilegio). Validar siempre la conexión HTTPS en producción.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.