proxmox-mcp

proxmox-mcp es un servidor local stdio con puerta de seguridad para el Protocolo de Contexto de Modelo (MCP) de la API de Proxmox VE. Se inicia como un proceso por un host MCP; no es un servicio HTTP y no expone un punto final HTTP.

Estado — versión actual: v0.1.1. La distribución canónica es el archivo de la versión de GitHub Release y su suma de verificación SHA-256. No se proporciona ni publica ningún paquete npm.

Instalar el Proxmox MCP publicado

Para una instalación local stdio, use el archivo de GitHub Release verificado por suma de verificación:

• GitHub Release v0.1.1

• Archivo de la versión

• Archivo de suma de verificación

No hay paquete npm. La lista de LobeHub Marketplace describe las capacidades; no es la fuente de instalación local. ClawHub no está publicado actualmente porque no hay disponible un envoltorio/lista de OpenClaw instalable públicamente.

Related MCP server: mcp-server-proxmox

Instalación rápida

Descargue el archivo v0.1.1 y la suma de verificación desde GitHub Releases, verifíquelos y extraiga el archivo. Haga esto en la máquina donde se ejecutará el host MCP.

curl -fLO https://github.com/Theorvane/proxmox-mcp/releases/download/v0.1.1/proxmox-mcp-0.1.1.tar.gz
curl -fLO https://github.com/Theorvane/proxmox-mcp/releases/download/v0.1.1/proxmox-mcp-0.1.1.tar.gz.sha256
shasum -a 256 -c proxmox-mcp-0.1.1.tar.gz.sha256
tar -xzf proxmox-mcp-0.1.1.tar.gz
cd proxmox-mcp-0.1.1

El archivo requiere Node.js >=22. Proporcione las credenciales a través del entorno; los valores siguientes son marcadores de posición, no credenciales funcionales.

export PROXMOX_BASE_URL='https://proxmox.example:8006'
export PROXMOX_TOKEN_ID='user@realm!token-name'
: "${PROXMOX_TOKEN_SECRET:?set PROXMOX_TOKEN_SECRET in the environment}"
./proxmox-mcp

./proxmox-mcp es un proceso stdio. Registre o configure ese comando, su directorio de trabajo y las tres variables de entorno en su host MCP; iniciarlo en una terminal solo no lo hace disponible para un cliente. Para conocer la estructura del archivo y los detalles de instalación, consulte la guía de instalación de GitHub Release.

Configuración

Solo se utilizan estas variables de entorno:

La verificación del certificado TLS está siempre habilitada. PROXMOX_TLS_VERIFY=false se rechaza al inicio; no lo use. Si el punto final de Proxmox utiliza una CA privada, confíe en esa CA en el almacén de confianza del host. Consulte configuración para conocer la política completa.

Capacidades

El servidor proporciona un conjunto enfocado de operaciones de Proxmox VE. Los hosts MCP descubren los esquemas exactos y las descripciones de las herramientas en el momento de la conexión.

Los nombres de las herramientas, entradas, salidas y reglas de validación de nombres de nodo están documentados en el contrato de herramientas.

Modelo de seguridad

La eliminación, la eliminación de discos no utilizados y la detención forzada pueden ser no recuperables. Revise los objetivos cuidadosamente y otorgue al token solo los permisos de Proxmox que necesite. Consulte la guía de seguridad completa.

Habilidad local de OpenClaw

El código base fusionado dev contiene una habilidad de OpenClaw en skills/proxmox-mcp-openclaw/. Es una habilidad local, no un complemento genérico de OpenClaw. Use sus instrucciones locales de SKILL.md.

Elija un nuevo directorio de destino absoluto—el destino no debe existir ya. Primero inspeccione el plan sin credenciales:

node skills/proxmox-mcp-openclaw/scripts/install.mjs --dry-run /absolute/path/to/proxmox-mcp

Con las tres variables de configuración exportadas en el shell, instálelo y regístrelo:

node skills/proxmox-mcp-openclaw/scripts/install.mjs /absolute/path/to/proxmox-mcp

El instalador verifica la versión inmutable v0.1.1 y su suma de verificación, luego invoca el comando openclaw mcp add compatible solo después de que la verificación previa sea exitosa. No registra ni almacena credenciales.

Límites operativos

• Esta es una integración MCP local stdio, no un servicio alojado ni un reemplazo de los controles de acceso de Proxmox.

• El servidor no realiza una solicitud a Proxmox hasta que un cliente MCP llama a una herramienta. Los ejemplos de instalación y documentación no llaman a una API real de Proxmox.

• Mantenga las credenciales fuera de los repositorios, del historial del shell cuando sea práctico y de los archivos de configuración compartidos. Use un token de API de Proxmox con privilegios mínimos.

• Obtenga las versiones solo de Theorvane/proxmox-mcp GitHub Releases y verifique la suma de verificación SHA-256 publicada antes de ejecutar el archivo.

Documentación

• Configuración

• Seguridad

• Contrato de API y herramientas

• Instalación de GitHub Release

• Contribuir

• Seguridad

Verificación y contribución

Los colaboradores trabajan desde una rama numerada por incidencia basada en dev, abren solicitudes de extracción a dev y promueven solo dev revisado a main. Los archivos de GitHub Release son el único canal de distribución. Consulte CONTRIBUTING.md.

Los mantenedores pueden ejecutar los mismos comandos de verificación local que utiliza el proyecto:

npm ci
npm run lint
npm run typecheck
npm test
npm run build
npm run release:archive
npm run verify:release-archive
npm run validate:docs
npm run validate:governance
npm run validate:release
npm audit --omit=dev --audit-level=high
git diff --check

Licencia

Este proyecto está licenciado bajo los términos en LICENSE.