Servidor MCP de Illustrator (Windows y macOS)

¡Bienvenido al Servidor MCP de Illustrator! 🎨🚀

Este proyecto permite a los agentes de IA crear gráficos vectoriales directamente dentro de Adobe Illustrator usando instrucciones en lenguaje natural. Funciona enviando comandos ExtendScript a Illustrator a través de un servidor MCP (Model Context Protocol) local.

Imagina simplemente describir lo que quieres — como "dibuja una pequeña cafetería bajo la lluvia" — ¡y Illustrator le dará vida!

Funciona en Windows (automatización COM) y macOS (AppleScript/osascript).

✨ Características

• Controla Adobe Illustrator mediante programación usando instrucciones de IA

• Envía scripts de ExtendScript (.jsx) directamente a Illustrator

• Captura capturas de pantalla de la ventana de Illustrator

• De código abierto y ligero

• Multiplataforma: Windows y macOS

• Multicliente: Funciona con Claude Desktop, Claude Code, Cursor, VS Code Copilot y JetBrains Copilot

💻 Instalación

Requisitos previos

• Python 3.12+ — Descargar Python

• Adobe Illustrator instalado y en ejecución

• Solo macOS: Concede permisos de automatización cuando se te solicite (Ajustes del Sistema → Privacidad y seguridad → Automatización)

1. Clonar el repositorio

git clone https://github.com/krVatsal/illustrator-mcp.git
cd illustrator-mcp

2. Crear un entorno virtual

macOS / Linux:

python3 -m venv .venv
source .venv/bin/activate

Windows:

python -m venv .venv
.\.venv\Scripts\activate

3. Instalar dependencias

pip install -r requirements.txt

En macOS, pywin32 se omite automáticamente. No se requieren paquetes adicionales de macOS.

4. Iniciar el servidor MCP (modo manual / depuración)

python -m illustrator

Ejecutar con un script (multiplataforma)

bash run_server.sh

Este script detecta automáticamente tu plataforma, crea un .venv, instala las dependencias e inicia el servidor.

🔌 Configuración del cliente

El servidor utiliza transporte stdio — compatible con todos los principales clientes MCP.

Importante: NO inicies el servidor manualmente cuando lo uses a través de un cliente. El cliente inicia y gestiona el proceso del servidor automáticamente.

Claude Desktop

macOS — edita ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "illustrator": {
      "command": "/path/to/illustrator-mcp/.venv/bin/python3",
      "args": ["-m", "illustrator"]
    }
  }
}

Windows — edita %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "illustrator": {
      "command": "C:\\Users\\<YourUser>\\illustrator-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m", "illustrator"]
    }
  }
}

Claude Code (CLI)

Se incluye un .claude/mcp.json en el repositorio. Claude Code lo detectará automáticamente. O añádelo manualmente:

claude mcp add illustrator python3 -- -m illustrator

GitHub Copilot (VS Code)

Se incluye un .vscode/mcp.json en el repositorio. VS Code (1.99+) lo detectará automáticamente. O añádelo a tu settings.json:

{
  "mcp": {
    "servers": {
      "illustrator": {
        "type": "stdio",
        "command": "python3",
        "args": ["-m", "illustrator"]
      }
    }
  }
}

🎯 Sistema de instrucciones mejorado

¡Este servidor MCP ahora incluye un sistema de instrucciones avanzado para ayudarte a crear mejor contenido! Usa estas nuevas herramientas:

• get_prompt_suggestions - Obtén ejemplos de instrucciones categorizados para diferentes tipos de contenido

• get_system_prompt - Obtén la instrucción de sistema óptima para la guía de la IA

• get_prompting_tips - Obtén consejos para crear instrucciones más efectivas

• get_advanced_template - Obtén plantillas estructuradas para tareas de diseño complejas

• help - Muestra ayuda y orientación completa

📚 Categorías de instrucciones disponibles:

• 🎨 Formas básicas y geometría

• 📝 Tipografía y texto

• 🏢 Logotipos y branding

• 🌆 Ilustraciones y escenas

• 🎭 Iconos y elementos de interfaz

• 🎨 Artístico y creativo

• 📊 Gráficos e infografías

• 🏷️ Impresión y maquetación

💡 Inicio rápido con instrucciones

Intenta preguntar: "Dame sugerencias de instrucciones para logotipos" o "Muéstrame consejos de redacción de instrucciones"

Para ejemplos detallados y plantillas, consulta PROMPT_EXAMPLES.md

📋 Instrucciones de muestra que probé

Aquí hay algunas instrucciones que utilicé junto con los resultados que generó:

• Instrucción 1: Diseña un arte vectorial limpio y minimalista de una pequeña cafetería bajo la lluvia, con un escaparate sencillo, charcos en la calle y suaves nubes grises en el cielo.

• Instrucción 2: Crea una ilustración al estilo acuarela del horizonte de Mumbai al atardecer.

• Instrucción 3: Crea un logotipo moderno y minimalista para una startup tecnológica llamada 'NeuraTech'.

(¡Mira las imágenes adjuntas para ver los resultados!)

🍎 Notas de macOS

• Adobe Illustrator debe estar instalado y en ejecución

• En el primer uso, macOS pedirá permiso de automatización — permite que tu terminal/IDE controle Illustrator

• Si ves errores de "Aplicación no ejecutándose", abre Illustrator primero

• Las capturas de pantalla capturan la pantalla completa (Illustrator debe estar en primer plano)

🪟 Notas de Windows

• Adobe Illustrator debe estar instalado

• Se requiere el paquete pywin32 (instalado automáticamente)

• La creación de scripts de Illustrator debe estar habilitada

📢 Contribuciones

¡Las solicitudes de extracción (pull requests) son bienvenidas! Siéntete libre de abrir problemas (issues) para solicitudes de funciones, errores o sugerencias.

¡Feliz creación! 🌈💛