Illustrator Figure MCP
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:
Canal | Mecanismo | Demuestra |
Geometría |
| corrección interna: contención, tamaños degenerados, nombres duplicados, texto desbordado, declaraciones raster, enrutado y enlaces de conectores, alineación de series repetidas, firmas de trazado |
Apariencia |
| semejanza |
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: visualspec
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. ElexpandTracing()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_imagerechaza 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:
Declaración | Requisito |
| descripción específica del contenido de píxeles irreducible — "imagen", "PNG", "captura de pantalla" son rechazados |
|
|
|
|
|
|
| ≥ 8 caracteres: qué se separó y reconstruyó |
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 buildAñádelo a Claude Code:
claude mcp add illustrator-figure -- node /absolute/path/to/IllustratorFigureMCP/dist/index.jsConcede 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:
Habilidad | Rol |
| Diseñador — produce la especificación de reconstrucción antes de dibujar nada |
| Dibujante + orquestador — construye una región por ronda, ejecuta las puertas |
| Revisor — lee ambos canales de evidencia, emite hallazgos |
| Corrector — convierte hallazgos en operaciones ordenadas a nivel de objeto |
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
Herramienta | Propósito |
| auditoría de estructura determinista; cada hallazgo lleva evidencia, una corrección y un criterio de aceptación |
| construye una región completa en una sola ronda, opcionalmente auditando en la misma llamada |
| crea un conector vinculado a dos objetos por nombre |
| vuelve a resolver la geometría del conector después de que los objetos se muevan |
| resuelve texto de área desbordado — redimensionar el marco con |
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
Cómo usarlo: instalación, reglas, todas las herramientas, ejemplos prácticos, hallazgos de auditoría, solución de problemas | |
Internals y las restricciones que son fáciles de romper, para cualquiera que edite este repo | |
Las cuatro habilidades de rol |
Desarrollo
npm test # 245 tests, runs on any platformLa 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
notey 63 herramientas de Illustrator. VerLICENSE.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.
This server cannot be deployed
Maintenance
Related MCP Connectors
Create and edit scientific figures, generate data charts, and export editable SVG and PowerPoint.
Convert images and infographics into editable PowerPoint (PPTX) and SVG files.
Compose multi-panel scientific figures for 16 journals - aligned axes, print-ready exports.
Traceable scientific novelty and evidence assessment with source-linked results and a human gate.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server that renders AI-authored documents to images and returns typed diagnostics for self-correction. It also provides visual QA metrics, raster-to-vector reconstruction, and image-to-draft proposals.MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to convert natural-language briefs into structured visual specs, deterministically render typography and layouts, and run constraint-aware visual QA and targeted repair for image generation.30 npmApache 2.0
- AlicenseNot gradedqualityAmaintenanceConverts raster drawings such as diagrams, maps, charts, and scans into editable CorelDRAW vector files in a single call, with automatic self-checking that reports uncertain elements back to the calling AI for correction and rebuild.4Apache 2.0
- AlicenseNot gradedqualityAmaintenanceEnables AI agents to create and edit vector drawing documents over MCP, with tools to draw shapes, read document outlines, and render PNG previews while humans work in the same Illustrator-style canvas.Apache 2.0