arcane-mcp conecta cualquier cliente MCP —Claude Desktop, Claude Code, VS Code con GitHub Copilot y el resto— con un servidor Arcane. Así puedes preguntar «¿qué contenedores están en mal estado en el entorno del NAS?», «descarga nginx:1.27 y vuelve a desplegar el proyecto web» o «enséñame las últimas 50 líneas de log del contenedor de la base de datos», y se hace a través de la propia API de Arcane, con los permisos de Arcane.
Paridad 1:1 con Arcane
Cada operación del documento OpenAPI de Arcane v2.17.2 (442) y cada ruta que Arcane sirve fuera de él —logs y estadísticas por WebSocket, el terminal de contenedores, pprof, el disparador de webhooks, el intercambio de tokens federados— corresponde a una acción del catálogo: 461 acciones en 52 dominios. Una auditoría en CI rompe la build si Arcane incorpora una ruta sin su acción.
Tres superficies, un solo catálogo
dynamic (predeterminada): dos herramientas, arcane_find_action y
arcane_execute_action. meta: una herramienta por dominio (52).
individual: una herramienta por acción (461). Las tres pasan por el
mismo código, así que no pueden divergir.
Seguro donde importa
Las acciones destructivas —borrados, limpiezas, kills, restauraciones,
redespliegues— exigen confirm: true. El modo de solo lectura elimina
todas las acciones que modifican algo; el modo seguro las responde con una
vista previa de la petición en lugar de enviarla.
Validado contra Arcane real
Una batería de pruebas de extremo a extremo ejecuta cada escenario en las tres superficies contra un entorno desechable Docker-in-Docker con gestores Arcane v2.17.2 reales, agentes directos y edge, un clúster Swarm y un host Podman, y un registro anota qué acciones ha ejercitado.
Esquemas sacados del propio Arcane
Los esquemas de entrada se derivan del documento OpenAPI de Arcane, que se genera a partir del mismo código que enruta las peticiones, de modo que el modelo ve exactamente lo que Arcane valida.
Los flujos se convierten en respuestas
Los logs, las estadísticas, el canal de eventos y el terminal de contenedores son acciones acotadas que escuchan unos segundos y devuelven lo recibido; las descargas de imágenes y los despliegues de proyectos se siguen hasta el final y se resumen.
