Illustrator Figure MCP

Reconstruye figuras científicas como arte editable de Adobe Illustrator y demuestra que el resultado es estructuralmente correcto.

Solo macOS (Illustrator es macOS/Windows; esto usa osascript → do javascript). Requiere Adobe Illustrator y Claude Code.

Por qué existe esto

Muchos servidores MCP pueden dibujar en Illustrator. Le dan al modelo manos pero sin ojos: nada comprueba si lo que acaba de dibujar es correcto. Así que el modelo dibuja, informa de éxito, y la figura tiene una etiqueta que se desborda de su caja, una flecha que termina en medio de un rectángulo no relacionado, y tres paneles "alineados" que están desviados 3pt.

Lo valioso no es el dibujo. Es el bucle de validación y reparación, en dos canales que comprueban cosas diferentes:

La geometría se prueba. La similitud se juzga. Ninguna de las dos es suficiente por sí sola: una figura trazada pasa todas las comprobaciones geométricas mientras es completamente no editable, y un render de buen aspecto no dice nada sobre la estructura.

audit_figure que devuelve passed: true significa sin fallos geométricos duros. No significa que la figura sea correcta.

Related MCP server: Illustrator MCP Vectorizer

Reconstruir, nunca trazar

Trazar preserva la apariencia y destruye la semántica, que es el objetivo de reconstruir una figura. Tres defensas hacen difícil tomar el atajo:

• Etiquetado semántico en la creación. Cada objeto recibe un UUID y un tipo semántico al crearse, para que el auditor pueda distinguir objetos construidos de geometría extraña.

• trace-signature. El expandTracing() de Image Trace deja caer un grupo sin etiquetar que contiene un montón de trazados sin etiquetar; eso, trazados densos sin etiquetar, y geometría masiva que excede el registro de dibujo declarado son fallos duros.

• La puerta raster. place_image rechaza cualquier colocación que no sea demostrablemente irreducible.

La puerta raster

Cada imagen retenida debe declarar los cinco, y se validan, no solo se registran:

La aplicación está en la ruta de creación, no en el auditor: una comprobación solo del auditor se evita no auditando.

Conectores

Illustrator no tiene primitiva de conector. Una flecha es un PathItem y no tiene relación con la caja a la que apunta: mueve la caja y la flecha se queda atrás, silenciosamente incorrecta.

add_connector registra el enlace (origen, destino, sitios de fijación) en el trazado. reflow_connectors vuelve a resolver la geometría a partir de los límites actuales de los objetos. audit_figure informa de connector-detached cuando el trazado dibujado ya no coincide con su enlace.

El enrutado es straight, orthogonal o curved — una bezier que sale y llega perpendicular a los bordes de fijación, que es el aspecto estándar de los diagramas de flujo y hace que las puntas de flecha se lean como apuntando directamente a su objetivo. El auditor muestrea la curva real en lugar de la cuerda entre anclas, así que comprueba dónde está la tinta.

Cualquier operación que mueva o redimensione un objeto conectado debe ir seguida de reflow_connectors. Las puntas de flecha se dibujan como triángulos rellenos, ya que Illustrator no expone ninguna propiedad de punta de flecha a los scripts.

→ Guía de uso completa — instalación, reglas básicas, referencia de herramientas, dos ejemplos prácticos y cómo leer un informe de auditoría.

Instalación

npm install && npm run build

Añádelo a Claude Code:

claude mcp add illustrator-figure -- node /absolute/path/to/IllustratorFigureMCP/dist/index.js

Concede permiso de Automatización la primera vez que se ejecute una herramienta: Configuración del sistema → Privacidad y seguridad → Automatización → Claude → Adobe Illustrator.

Instala las cuatro habilidades de rol:

cp -R skills/* ~/.claude/skills/

Los cuatro roles

Pide a Claude que "recrea esta figura en Illustrator" con una imagen de referencia, y recreate-scientific-figure coordina el bucle:

Cada región debe pasar antes de que comience la siguiente; luego toda la figura ejecuta el mismo bucle.

Herramientas añadidas por este fork

Además, la puerta raster en place_image y el etiquetado semántico en cada herramienta create_*. Las 66 herramientas restantes son del upstream (71 en total).

draw_sequence es la que hay que usar: nueve objetos — cajas, etiquetas de texto de área, dos conectores vinculados — se construyen y auditan en aproximadamente 750 ms, donde una llamada por objeto serían nueve rondas.

Documentación

Desarrollo

npm test        # 245 tests, runs on any platform

La geometría portada es ES3 puro, así que los módulos .jsx se cargan en una VM y las matemáticas de Liang–Barsky y de cruce de segmentos se prueban sin Illustrator. Cualquier cosa que toque Illustrator debe probarse en macOS con él en ejecución — consulta CLAUDE.md para las restricciones que son fáciles de romper (ES3, orden UUID-antes-de-metadatos, captura de pageItems).

Créditos

• Capa de herramientas bifurcada de ie3jp/illustrator-mcp-server (MIT) — transporte, ejecutor JSX, identidad UUID, metadatos note y 63 herramientas de Illustrator. Ver LICENSE.

• El bucle de validación de dos canales, la taxonomía de auditoría y el protocolo de cuatro roles están portados de icebird1998/scientific-illustrator, que los implementa para draw.io, PowerPoint y WPS. Las matemáticas son neutrales al backend; el modelo de objetos no lo es.

No afiliado con Adobe.