illustrator-mcp

Servidor MCP que controla Adobe Illustrator en Windows. Se comunica con Illustrator mediante automatización COM (New-Object -ComObject Illustrator.Application en PowerShell) y ejecuta ExtendScript (el lenguaje de scripting basado en JS de Illustrator) a través de app.DoJavaScript. No se requieren complementos nativos de Node ni herramientas de compilación de Visual Studio: todo se realiza mediante powershell.exe, que viene incluido con Windows.

Requisitos

• Windows con Adobe Illustrator instalado (probado con Illustrator 2026 / versión de la aplicación 30.8).

• Node.js 18+.

Related MCP server: illustrator-mcp

Configuración

npm install
npm run build

Registro con Claude Code

claude mcp add illustrator-mcp -- node E:/Repositorios/illustrator-mcp/dist/index.js

(Reinicia tu sesión de Claude Code después para que detecte el nuevo servidor).

Herramientas

• illustrator_status — se conecta a Illustrator (iniciándolo si es necesario) y enumera los documentos abiertos.

• illustrator_create_document — nuevo documento (ancho/alto en puntos, RGB o CMYK).

• illustrator_open_document — abre un archivo .ai/.eps/.pdf/.svg existente.

• illustrator_save_document — guarda en el lugar actual, o Guardar como si se indica una ruta.

• illustrator_export_document — exporta el documento activo a png/jpg/pdf/svg.

• illustrator_add_rectangle / illustrator_add_ellipse — dibuja una forma con relleno/trazo hexadecimal opcional.

• illustrator_add_text — añade un marco de texto puntual.

• illustrator_document_info — nombre, ruta, tamaño, mesas de trabajo y capas del documento activo.

• illustrator_run_script — vía de escape: ejecuta cualquier ExtendScript y devuelve la última expresión como cadena. Úsalo para cualquier cosa que las demás herramientas no cubran (selecciones, capas, efectos, procesamiento por lotes, el modelo de objetos completo de Illustrator).

Todas las coordenadas para formas/texto están en puntos, medidas desde la esquina superior izquierda de la mesa de trabajo (las herramientas convierten al sistema de coordenadas nativo de Illustrator, con origen en la esquina inferior izquierda, internamente).

Cómo funciona

Cada llamada a una herramienta genera un pequeño fragmento de ExtendScript, lo escribe en un archivo .jsx temporal y lo ejecuta mediante scripts/run-illustrator.ps1, que se conecta a Illustrator a través de COM y evalúa ese archivo con $.evalFile(...). El valor de retorno del script (su última expresión) se devuelve como salida de texto de la herramienta. Los errores lanzados dentro del ExtendScript se capturan y se muestran como errores de la herramienta, sin provocar que el puente se bloquee.