MCP

ArchLang, DSL y compilador de planos: para quién es, primera prueba en 3 minutos y límites de uso

ArchLang encaja sobre todo si escribes planos como fuente .arch (un agente de IA puede escribirlos por ti) y los compilas a SVG/DXF/PDF con lint y validación geométrica; el requisito es que tu máquina ejecute @chanmeng666/archlang con npx, para una primera prueba el subcomando context devuelve toda la descripción del lenguaje en una sola llamada, y compile escribe el archivo resultante localmente.

Official source · ArchLang

Install

npx -y skills add ChanMeng666/archlang --yes

Para quién es

  • Encaja sobre todo para dos perfiles: quien quiere que un agente escriba por él el código fuente del plano y luego compilarlo —el posicionamiento oficial es «escribe código fuente .arch, o deja que un agente de IA lo escriba»— y quien necesita obtener rápido planos en SVG, DXF o PDF, controlando el código con lint y validación geométrica.
  • También sirve a quien mete la revisión de planos en scripts: describe y validate admiten salida --json, lo que permite valorar por programa el estado del código.
  • Trata los planos como código: el archivo fuente es texto plano, las descripciones de distribución son reproducibles y comparables, y resulta cómodo encargar cambios a un agente; el producto compilado es un archivo de dibujo en formato vectorial o de documento.
  • Requisitos previos: todos los comandos oficiales ejecutan un paquete npm a través de npx, así que tu máquina debe poder lanzar npx; la ruta de instalación principal apunta a las skills de un coding agent, y los subcomandos de la CLI se ejecutan en el terminal sin conectar ningún cliente MCP.
  • Para quién no es, y desconocidos: las pruebas no muestran edición visual ni dibujo arrastrando y soltando, así que no encaja si buscas dibujar en WYSIWYG; ningún ejemplo de sintaxis .arch aparece en las pruebas, así que el primer archivo fuente lo escribes tú o un agente; la precisión y conformidad normativa para planos de ingeniería formales, los sistemas operativos soportados y la licencia quedan sin mención.

Primera prueba en 3 minutos

Solo hay una ruta principal: la instalación de skills, en cuatro pasos.

  1. Requisito previo: que npx funcione en tu terminal; los comandos oficiales no llevan claves ni parámetros de cuenta, así que no hace falta preparar credenciales. Si exige alguna otra configuración de entorno, las pruebas no lo dicen.
  2. Instalación: ejecuta npx -y skills add ChanMeng666/archlang --yes para instalar las skills de este repositorio en tu coding agent.
  3. Primera prueba barata: ejecuta npx -y @chanmeng666/archlang context. El posicionamiento oficial es «todo el lenguaje ArchLang en una sola llamada», de modo que el agente no necesita precargar conocimiento del lenguaje. Señal de éxito: el terminal imprime la descripción del lenguaje. Si el comando accede a la red y otros detalles de lectura/escritura, las pruebas no lo dicen.
  4. Conseguir el primer producto: con un plan.arch preparado, ejecuta npx -y @chanmeng666/archlang compile plan.arch -o plan.svg --json; la señal de éxito es que se genera plan.svg en local y se imprime un estado JSON. Ten en cuenta que compile escribe un archivo local —una escritura local, no una operación de solo lectura—, por lo que conviene ejecutarlo tras confirmar el contenido del código.

Nota secundaria (otra ruta oficial, que no se pone al mismo nivel que la principal): un cliente MCP puede ejecutar claude mcp add archlang -- npx -y @chanmeng666/archlang-mcp, que lanza mediante npx el paquete npm independiente @chanmeng666/archlang-mcp y registra un servidor llamado archlang; qué herramientas MCP expone ese servidor tras registrarse, las pruebas no lo dicen.

Casos de uso

Caso uno: inspeccionar antes de compilar. Escenario: ya tienes un plan.arch y quieres confirmar que su contenido es fiable antes de sacar el dibujo. Manera de hacerlo: ejecuta primero describe plan.arch --json para ver la descripción estructural y luego validate plan.arch --strict --json para la validación estricta; ambos comparten prefijo de comando con compile; tras corregir el código según los resultados, se recompila, que es justo el flujo oficial de corregir y volver a compilar. Resultados esperables: descripción y validación en formato JSON, con los problemas geométricos aflorando antes de compilar el dibujo. Los dos comandos llevan --json, idóneos para enchufarlos a scripts como comprobación previa a la compilación; la estructura exacta de campos de la salida de validación no figura en las pruebas.

Caso dos: dejar que el agente escriba el dibujo. Escenario: no dominas la sintaxis .arch y prefieres delegar el código en un agente. Manera de hacerlo: ejecuta primero npx -y @chanmeng666/archlang context para entregar de una vez todo el lenguaje al agente —oficialmente sin necesidad de precargar conocimiento del lenguaje—; el agente produce después el código .arch; por último, el comando compile genera el dibujo. El código lo produce el agente; compilar y validar siguen siendo comandos locales. Resultados esperables: el código y tu primer plan.svg. El posicionamiento del proyecto admite salida SVG, DXF o PDF, pero el comando de compilación copiable literal que aparece en las pruebas cubre solo SVG; los parámetros exactos de salida para DXF y PDF no están confirmados, no los extrapoles por tu cuenta.

Límites de uso

  • Naturaleza de lectura/escritura: compile lee plan.arch y escribe plan.svg en local según -o, una escritura local clara; describe, validate y context no están etiquetados oficialmente como herramientas de solo lectura, de context solo se dice que imprime la descripción del lenguaje, y el resto de detalles no aparecen en las pruebas.
  • Credenciales y configuración: ninguno de los comandos oficiales anteriores incluye claves ni tokens, ni aparecen datos obligatorios tipo nombre o correo; si existe algún requisito extra de configuración de entorno, las pruebas no lo dicen.
  • Distinción de rutas: la primera prueba de este artículo se basa en los subcomandos de la CLI y la instalación de skills; si el objetivo es que llamen agentes dentro de un cliente MCP, hay que ejecutar aparte el comando de registro: las dos rutas instalan contenidos distintos con requisitos distintos.
  • Efectos secundarios y puntos de comprobación: compile escribe un archivo local, confirma la ruta de salida antes de ejecutarlo; no hay descripción oficial de cómo deshacerlo, así que no conviene llamarlo «reversible». En qué ubicaciones escribe exactamente la instalación de skills, las pruebas no lo dicen.
  • Los dos artefactos son independientes: la instalación de skills apunta al paquete de habilidades del agente; claude mcp add registra otro paquete npm. Su relación y si basta con instalar uno solo no aparecen en las pruebas.
  • Licencia, plataformas soportadas, comportamiento de red y límites de datos no figuran en las pruebas; «no encontrado» no significa «sin riesgo», y este artículo no emite conclusiones de seguridad propias.