ProxmoxMCP-Plus
Servidor MCP de RekklesNA
Gestiona máquinas virtuales de Proxmox VE, contenedores LXC, snapshots, backups, almacenamiento y estado del clúster desde un asistente de IA.
Instalar ProxmoxMCP-Plus
Se ejecuta en tu equipo. Tu cliente lo inicia con este comando:
Requiere uv (Python) en tu equipo. Los pasos de configuración de abajo muestran dónde va el comando en cada cliente.
PROXMOX_MCP_CONFIGopcional Optional path to a JSON config file. If set, file config is used before environment variable fallback.PROXMOX_HOSTHostname or IP address of the Proxmox VE API endpoint.PROXMOX_USERProxmox username with realm, for example root@pam.PROXMOX_TOKEN_NAMEName of the Proxmox API token.PROXMOX_TOKEN_VALUEsecreto Secret value of the Proxmox API token.PROXMOX_PORTopcional Proxmox API port. Defaults to 8006.
Compartir este servidor
El enlace abre esta página, con el comando de instalación y los pasos de configuración.
mcp.tc/i/proxmoxmcp-plusDescripción
ProxmoxMCP-Plus se conecta a un clúster de Proxmox VE a través de su API y ofrece acciones del ciclo de vida de VM y LXC, snapshots, backups, gestión de ISO, inspección del almacenamiento y del clúster, lectura de logs y seguimiento persistente de tareas de larga duración. También puede ejecutar comandos de shell protegidos en invitados y en nodos.
Se ejecuta en local mediante stdio con uvx proxmox-mcp-plus, o como servidor Streamable HTTP en Docker que requiere una clave bearer. El acceso necesita un token de API de Proxmox (host, usuario, nombre del token y valor del token), configurado mediante variables de entorno o un archivo de configuración JSON. Las listas de permitidos y denegados de herramientas pueden limitar lo que se expone.
Qué puedes hacer
- Listar nodos, VM, contenedores, almacenamiento y estado del clúster
- Crear, clonar, iniciar, detener y eliminar VM y contenedores LXC
- Crear, revertir y eliminar snapshots
- Crear, restaurar y eliminar backups
- Ejecutar comandos en VM, contenedores y nodos
- Seguir, consultar, cancelar y reintentar trabajos de larga duración
- Leer los logs de syslog, tareas, clúster y firewall
Herramientas 68
list_targetsListar los destinos de Proxmox configurados sin exponer credenciales
get_nodesListar todos los nodos del clúster
get_node_statusObtener el estado detallado de un nodo
get_node_timeRead node clock and timezone for authentication skew diagnostics
get_node_diagnosticsRead per-node CPU, memory, storage and recent disk/network metrics
get_vmsListar todas las máquinas virtuales del clúster
preflight_vm_migrationRead-only QEMU migration safety assessment
migrate_vmGuarded offline QEMU VM migration with local disks
configure_vm_serial_consoleEnable a socket-backed serial console for a stopped VM
import_cloud_imageImport existing disk image from import-enabled Proxmox storage
get_vm_configObtener la configuración completa de una VM QEMU
set_vm_descriptionEstablecer la descripción de Notes de una VM QEMU
Mostrar 56 herramientas más
update_vm_configActualizar el dimensionamiento de la VM y los ajustes de cloud-init
get_vm_ip_addressesObtener las interfaces de red y las IP de una VM mediante el guest agent
get_next_vmidObtener el siguiente ID libre de VM/contenedor
create_vmCrear una nueva máquina virtual
clone_vmClonar una máquina virtual existente
execute_vm_commandEjecutar un comando de shell en una VM mediante QEMU Guest Agent
start_vmIniciar una máquina virtual
stop_vmForzar la detención de una máquina virtual
shutdown_vmApagar de forma ordenada una máquina virtual
reset_vmReiniciar (reset) una máquina virtual
delete_vmEliminar por completo una máquina virtual
get_storageListar los pools de almacenamiento disponibles
get_node_storageRead node-specific capacity, status and content capability of storage pools
get_cluster_statusObtener el estado y la salud del clúster
get_cluster_join_infoRead cluster join information and certificate fingerprint with credential redaction
list_jobsListar los trabajos de tareas persistentes de Proxmox
get_jobObtener un trabajo persistente por ID
poll_jobConsultar el estado actual de un trabajo de tarea
cancel_jobSolicitar la cancelación de un trabajo de tarea
retry_jobReintentar un trabajo fallido o cancelado que sea elegible
get_containersListar todos los contenedores LXC
preflight_container_migrationRead-only, fail-closed preflight checks for LXC migration
start_containerIniciar contenedores LXC
stop_containerDetener contenedores LXC
restart_containerReiniciar contenedores LXC
update_container_resourcesActualizar la CPU, la memoria o el disco de un contenedor LXC
create_containerCrear un nuevo contenedor LXC
delete_containerEliminar contenedores LXC
migrate_containerSubmit an explicitly confirmed LXC migration and track its task
execute_container_commandEjecutar un comando de shell en un contenedor LXC mediante SSH
execute_node_commandEjecutar un comando de shell autorizado en un nodo mediante SSH
update_container_ssh_keysActualizar el authorized_keys de root en un contenedor LXC
get_container_configObtener la configuración completa de un contenedor LXC
set_container_descriptionEstablecer la descripción de Notes de un contenedor LXC
get_container_ipObtener la información de IP actual de un contenedor LXC
list_snapshotsListar los snapshots de una VM o contenedor
create_snapshotCrear un nuevo snapshot
delete_snapshotEliminar un snapshot concreto
rollback_snapshotRevertir a un snapshot concreto
list_isosListar las imágenes ISO disponibles
list_templatesListar las plantillas LXC disponibles
download_isoDescargar una imagen ISO
download_templateDownload an LXC template archive to Proxmox storage
delete_isoEliminar una ISO o plantilla
list_backupsListar los backups disponibles
create_backupCrear un backup de una VM o contenedor
restore_backupRestaurar desde un backup
delete_backupEliminar un backup concreto
get_node_syslogLeer entradas de syslog de un nodo de Proxmox
get_task_logObtener la salida del log de una tarea concreta de Proxmox por su UPID
get_cluster_logLeer las entradas recientes del log de todo el clúster
get_node_firewall_logLeer el log del firewall del host de un nodo de Proxmox
get_guest_firewall_logLeer el log del firewall de una VM (qemu) o contenedor (lxc)
update_container_networkActualizar una interfaz de red LXC existente, conservando los ajustes de NIC no especificados.
list_bridgesListar los bridges Linux/OVS y las VNets SDN permitidas en un nodo seleccionado.
reconcile_jobConciliar un reintento incierto con un UPID de tarea verificado o con la confirmación explícita de que no se envió ninguna tarea.
Tomadas el 12 oct 2026 del manifiesto del paquete, no de una conexión en directo.
Prompts de ejemplo
Lista todas las VM de mi clúster de Proxmox y su estado
Crea un snapshot de la VM 102 antes de actualizarla
Muestra la dirección IP del contenedor LXC 205
Haz un backup del contenedor 110 y avísame cuando termine el trabajo
Configuración
Todos los clientes inician ProxmoxMCP-Plus en tu equipo con el mismo comando. Elige el tuyo; la página recuerda tu elección.
Claude Code
- Ejecútalo en un terminal, en la carpeta de tu proyecto:
claude mcp add --transport stdio proxmoxmcp-plus --env "PROXMOX_HOST=<YOUR_PROXMOX_HOST>" --env "PROXMOX_USER=<YOUR_PROXMOX_USER>" --env "PROXMOX_TOKEN_NAME=<YOUR_PROXMOX_TOKEN_NAME>" --env "PROXMOX_TOKEN_VALUE=<YOUR_PROXMOX_TOKEN_VALUE>" -- uvx proxmox-mcp-plus- Inicia Claude Code y escribe
/mcp. proxmoxmcp-plus debería aparecer como conectado.
Añade --scope user para que esté disponible en todos los proyectos. Sustituye los marcadores por tus propios valores.
Claude Desktop
- Abre Settings → Developer → Edit Config. Se abre
claude_desktop_config.json. Añade:
{
"mcpServers": {
"proxmoxmcp-plus": {
"command": "uvx",
"args": [
"proxmox-mcp-plus"
],
"env": {
"PROXMOX_HOST": "<YOUR_PROXMOX_HOST>",
"PROXMOX_USER": "<YOUR_PROXMOX_USER>",
"PROXMOX_TOKEN_NAME": "<YOUR_PROXMOX_TOKEN_NAME>",
"PROXMOX_TOKEN_VALUE": "<YOUR_PROXMOX_TOKEN_VALUE>"
}
}
}
}- Guarda el archivo y reinicia Claude Desktop. Sustituye los marcadores por tus propios valores.
Necesita uv (Python) en tu equipo. El archivo está en ~/Library/Application Support/Claude/ en macOS y en %APPDATA%\Claude\ en Windows.
Cursor
Añadir a Cursor (se abre en una pestaña nueva)
O añádelo a mano en ~/.cursor/mcp.json (todos los proyectos) o en .cursor/mcp.json (este proyecto):
{
"mcpServers": {
"proxmoxmcp-plus": {
"command": "uvx",
"args": [
"proxmox-mcp-plus"
],
"env": {
"PROXMOX_HOST": "<YOUR_PROXMOX_HOST>",
"PROXMOX_USER": "<YOUR_PROXMOX_USER>",
"PROXMOX_TOKEN_NAME": "<YOUR_PROXMOX_TOKEN_NAME>",
"PROXMOX_TOKEN_VALUE": "<YOUR_PROXMOX_TOKEN_VALUE>"
}
}
}
}Necesita uv (Python) en tu equipo. Sustituye los marcadores por tus propios valores.
VS Code
Añádelo a .vscode/mcp.json. VS Code pide el secreto la primera vez y lo guarda de forma segura:
{
"servers": {
"proxmoxmcp-plus": {
"type": "stdio",
"command": "uvx",
"args": [
"proxmox-mcp-plus"
],
"env": {
"PROXMOX_HOST": "<YOUR_PROXMOX_HOST>",
"PROXMOX_USER": "<YOUR_PROXMOX_USER>",
"PROXMOX_TOKEN_NAME": "${input:proxmox-token-name}",
"PROXMOX_TOKEN_VALUE": "${input:proxmox-token-value}"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "proxmox-token-name",
"description": "PROXMOX_TOKEN_NAME",
"password": true
},
{
"type": "promptString",
"id": "proxmox-token-value",
"description": "PROXMOX_TOKEN_VALUE",
"password": true
}
]
}Necesita uv (Python) en tu equipo.
Devin Desktop
- Añádelo a
~/.config/devin/mcp_config.json(macOS y Linux) o a%APPDATA%\devin\mcp_config.json(Windows):
{
"mcpServers": {
"proxmoxmcp-plus": {
"command": "uvx",
"args": [
"proxmox-mcp-plus"
],
"env": {
"PROXMOX_HOST": "<YOUR_PROXMOX_HOST>",
"PROXMOX_USER": "<YOUR_PROXMOX_USER>",
"PROXMOX_TOKEN_NAME": "<YOUR_PROXMOX_TOKEN_NAME>",
"PROXMOX_TOKEN_VALUE": "<YOUR_PROXMOX_TOKEN_VALUE>"
}
}
}
}- Actualiza la lista de servidores MCP en Cascade. Sustituye los marcadores por tus propios valores.
Devin Desktop es el nuevo nombre de Windsurf.
Codex
codex mcp add proxmoxmcp-plus --env "PROXMOX_HOST=<YOUR_PROXMOX_HOST>" --env "PROXMOX_USER=<YOUR_PROXMOX_USER>" --env "PROXMOX_TOKEN_NAME=<YOUR_PROXMOX_TOKEN_NAME>" --env "PROXMOX_TOKEN_VALUE=<YOUR_PROXMOX_TOKEN_VALUE>" -- uvx proxmox-mcp-plusO edita directamente ~/.codex/config.toml:
[mcp_servers.proxmoxmcp-plus]
command = "uvx"
args = ["proxmox-mcp-plus"]
env = { PROXMOX_HOST = "<YOUR_PROXMOX_HOST>", PROXMOX_USER = "<YOUR_PROXMOX_USER>", PROXMOX_TOKEN_NAME = "<YOUR_PROXMOX_TOKEN_NAME>", PROXMOX_TOKEN_VALUE = "<YOUR_PROXMOX_TOKEN_VALUE>" }Necesita uv (Python) en tu equipo. Sustituye los marcadores por tus propios valores.
Gemini CLI
gemini mcp add -e "PROXMOX_HOST=<YOUR_PROXMOX_HOST>" -e "PROXMOX_USER=<YOUR_PROXMOX_USER>" -e "PROXMOX_TOKEN_NAME=<YOUR_PROXMOX_TOKEN_NAME>" -e "PROXMOX_TOKEN_VALUE=<YOUR_PROXMOX_TOKEN_VALUE>" proxmoxmcp-plus uvx proxmox-mcp-plusAsí lo añades al proyecto actual. Añade -s user para usarlo en todas partes.
Cualquier cliente
La mayoría de los clientes que inician servidores locales aceptan esta forma:
{
"mcpServers": {
"proxmoxmcp-plus": {
"command": "uvx",
"args": [
"proxmox-mcp-plus"
],
"env": {
"PROXMOX_HOST": "<YOUR_PROXMOX_HOST>",
"PROXMOX_USER": "<YOUR_PROXMOX_USER>",
"PROXMOX_TOKEN_NAME": "<YOUR_PROXMOX_TOKEN_NAME>",
"PROXMOX_TOKEN_VALUE": "<YOUR_PROXMOX_TOKEN_VALUE>"
}
}
}
}Zed pone los servidores bajo context_servers en sus ajustes, con los mismos campos command, args y env.
Necesita uv (Python) en tu equipo. Sustituye los marcadores por tus propios valores.
Insertar
Muestra ProxmoxMCP-Plus en un README o en tu web. Cada inserción enlaza a esta página, usa el comando de instalación del servidor y no instala cookies. Cómo funcionan las inserciones
La tarjeta, el iframe y el JSON están en inglés. Añade ?lang=it, fr, de o es a su dirección para otro idioma.
Insignia para README
[](https://mcp.tc/i/proxmoxmcp-plus)<a href="https://mcp.tc/i/proxmoxmcp-plus"><img src="https://mcp.tc/i/proxmoxmcp-plus/badge.svg" alt="ProxmoxMCP-Plus on mcp.tc" height="20"></a>Sigue el modo claro u oscuro de quien lee. Añade ?theme=light o ?theme=dark para fijarlo, o ?style=compact para mostrar el símbolo sin la palabra.
Tarjeta para web
<script src="https://mcp.tc/w/proxmoxmcp-plus.js" async></script>La tarjeta aparece donde esté la etiqueta. Añade data-theme="dark" o data-size="compact" a la etiqueta para cambiarla. El archivo contiene todo lo que necesita, así que no hace otras solicitudes ni instala cookies.
iframe
<iframe src="https://mcp.tc/embed/proxmoxmcp-plus" title="ProxmoxMCP-Plus on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>Úsalo en páginas que no permiten scripts. Añade ?theme=light o ?theme=dark a la dirección para fijar los colores.
JSON
La ficha como datos para tus propias páginas y herramientas: nombre, descripción corta, comando de instalación, herramientas y los enlaces «Add to». Cualquier web puede leerla (CORS abierto).
https://mcp.tc/i/proxmoxmcp-plus.jsonPrompt para la IA
Pégalo en un asistente de programación con IA, como Claude Code o Cursor, y añadirá la tarjeta de ProxmoxMCP-Plus a tu web.
Añade a mi web la tarjeta de mcp.tc de ProxmoxMCP-Plus, un servidor MCP. Es un solo script estático: sin paso de build, sin paquetes que instalar, sin cookies.
Pon esta etiqueta donde deba aparecer la tarjeta. La tarjeta se muestra justo antes de ella:
```html
<script src="https://mcp.tc/w/proxmoxmcp-plus.js" async></script>
```
Para mostrarla en otro sitio, pon allí este marcador y carga el mismo script una sola vez, por ejemplo antes de `</body>`. Deja el enlace dentro: lo ven los visitantes sin JavaScript.
```html
<div data-mcptc="proxmoxmcp-plus"><a href="https://mcp.tc/i/proxmoxmcp-plus">ProxmoxMCP-Plus on mcp.tc</a></div>
```
Opciones:
- `data-theme="light"` o `"dark"` en la etiqueta o el marcador fija los colores. Sin él, la tarjeta sigue el modo claro u oscuro del visitante.
- `data-size="compact"` da una tarjeta más pequeña, sin el eslogan.
- La variable CSS `--mcptc-max-width` en el marcador o en un elemento padre fija el ancho (por defecto `520px`).
- `?lang=` en la URL del script fija el idioma de la tarjeta: `en`, `it`, `fr`, `de` o `es`.
Si el sitio tiene una Content Security Policy, permite `script-src https://mcp.tc` e `img-src data:` (el icono va incrustado).
Para un README u otra documentación en Markdown, usa la insignia:
```markdown
[](https://mcp.tc/i/proxmoxmcp-plus)
```
Referencia: https://mcp.tc/es/embedHistorial de cambios
Leemos la lista de herramientas del manifiesto del bundle de este servidor en GitHub cada 3 horas y registramos lo que cambia. Última lectura: 18 nov 2026, 05:30 UTC.
-
Nueva versión 0.7.1 (antes 0.7.0). Leída en PyPI.
-
Nueva versión 0.7.0 (antes 0.6.10). Leída en PyPI.
-
Nueva versión 0.6.10 (antes 0.6.9). Leída en PyPI.
-
Nueva versión 0.6.9 (antes 0.6.8). Leída en PyPI.
-
Nueva versión 0.6.8 (antes 0.6.7). Leída en PyPI.
-
Nueva versión 0.6.7 (antes 0.6.6). Leída en PyPI.
-
Nueva versión 0.6.6 (antes 0.6.5). Leída en PyPI.
-
5 herramientas añadidas.
Detalles, 19 oct 2026, 04:36 UTC
Añadidas 5
configure_vm_serial_consoleEnable a socket-backed serial console for a stopped VM
download_templateDownload an LXC template archive to Proxmox storage
import_cloud_imageImport existing disk image from import-enabled Proxmox storage
migrate_vmGuarded offline QEMU VM migration with local disks
preflight_vm_migrationRead-only QEMU migration safety assessment
-
6 herramientas añadidas.
Detalles, 18 oct 2026, 07:33 UTC
Añadidas 6
get_cluster_join_infoRead cluster join information and certificate fingerprint with credential redaction
get_node_diagnosticsRead per-node CPU, memory, storage and recent disk/network metrics
get_node_storageRead node-specific capacity, status and content capability of storage pools
get_node_timeRead node clock and timezone for authentication skew diagnostics
migrate_containerSubmit an explicitly confirmed LXC migration and track its task
preflight_container_migrationRead-only, fail-closed preflight checks for LXC migration
-
Nueva versión 0.6.3 (antes 0.6.2). Leída en PyPI.
-
Inicio del seguimiento: 57 herramientas.
Preguntas frecuentes
¿Puedo pegar mcp.tc/i/proxmoxmcp-plus en mi cliente MCP?
No. ProxmoxMCP-Plus se ejecuta en tu propio equipo, iniciado por tu cliente, así que no tiene una dirección web a la que conectarse. El enlace rápido es la página para compartir; el comando de instalación es uvx proxmox-mcp-plus.
¿ProxmoxMCP-Plus necesita una clave de API?
Sí. Lee PROXMOX_HOST, PROXMOX_USER, PROXMOX_TOKEN_NAME y PROXMOX_TOKEN_VALUE de su entorno, y PROXMOX_TOKEN_NAME y PROXMOX_TOKEN_VALUE son secretos. Pon los valores en la configuración de tu cliente en tu propio equipo, nunca en un archivo compartido.
¿ProxmoxMCP-Plus es un servidor remoto o local?
Local. Tu cliente lo inicia como un proceso en tu equipo con uvx proxmox-mcp-plus, que necesita uv (Python).
¿Qué puede hacer ProxmoxMCP-Plus?
Tiene 68 herramientas, entre ellas list_targets, get_nodes y get_node_status. Puedes listar nodos, VM, contenedores, almacenamiento y estado del clúster, crear, clonar, iniciar, detener y eliminar VM y contenedores LXC y crear, revertir y eliminar snapshots.
¿Qué clientes pueden usarlo?
Cualquier cliente que inicie servidores locales: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed y otros. claude.ai y ChatGPT solo se conectan a servidores remotos.
¿mcp.tc sigue los cambios de ProxmoxMCP-Plus?
Sí. Seguimos la lista de herramientas del manifiesto del bundle de ProxmoxMCP-Plus, y su pestaña Historial muestra cada cambio que encontramos, además de las versiones nuevas y las ediciones de su responsable. Sigue la ficha para recibir un correo cuando cambie.
¿Quién escribió esta página?
El robot de mcp.tc leyó los metadatos públicos de ProxmoxMCP-Plus (las páginas de su paquete y de su repositorio), y un modelo de IA redactó el texto a partir de ellos. Una persona revisa todo lo que las comprobaciones no pueden confirmar. Aun así, el texto puede contener errores, así que si encuentras uno, usa Reportar esta ficha en esta página. Esta traducción la hizo un modelo de IA a partir del texto en inglés.
mcp.tc no tiene relación con RekklesNA. Esta página se creó a partir de los metadatos públicos de ProxmoxMCP-Plus, comprobados por última vez el 12 oct 2026, y un modelo de IA escribió la descripción, así que puede contener errores. Los nombres y marcas pertenecen a sus titulares. ¿Algo no cuadra? Reportar esta ficha. La traducción la hizo un modelo de IA a partir del texto en inglés.