Illustrator MCP Server (Windows и macOS)

Добро пожаловать в Illustrator MCP Server! 🎨🚀

Этот проект позволяет ИИ-агентам напрямую создавать векторную графику в Adobe Illustrator с помощью текстовых запросов. Он работает путем отправки команд ExtendScript в Illustrator через локальный сервер MCP (Model Context Protocol).

Представьте, что вы просто описываете то, что хотите — например, «нарисуй маленькую кофейню во время дождя» — и Illustrator воплощает это в жизнь!

Работает в Windows (автоматизация COM) и macOS (AppleScript/osascript).

✨ Функции

• Программное управление Adobe Illustrator с помощью ИИ-запросов

• Отправка скриптов ExtendScript (.jsx) напрямую в Illustrator

• Создание скриншотов окна Illustrator

• Открытый исходный код и легковесность

• Кроссплатформенность: Windows и macOS

• Мультиклиентность: работает с Claude Desktop, Claude Code, Cursor, VS Code Copilot и JetBrains Copilot

💻 Установка

Предварительные требования

• Python 3.12+ — Скачать Python

• Установленный и запущенный Adobe Illustrator

• Только для macOS: Предоставьте разрешения на автоматизацию при появлении запроса (Системные настройки → Конфиденциальность и безопасность → Автоматизация)

1. Клонируйте репозиторий

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

2. Создайте виртуальное окружение

macOS / Linux:

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

Windows:

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

3. Установите зависимости

pip install -r requirements.txt

В macOS пакет pywin32 автоматически пропускается. Дополнительные пакеты для macOS не требуются.

4. Запустите MCP Server (ручной режим / режим отладки)

python -m illustrator

Запуск с помощью одного скрипта (кроссплатформенно)

bash run_server.sh

Этот скрипт автоматически определяет вашу платформу, создает .venv, устанавливает зависимости и запускает сервер.

🔌 Конфигурация клиента

Сервер использует транспорт stdio — совместим со всеми основными MCP-клиентами.

Важно: НЕ запускайте сервер вручную при использовании через клиент. Клиент запускает и управляет процессом сервера автоматически.

Claude Desktop

macOS — отредактируйте ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Windows — отредактируйте %APPDATA%\Claude\claude_desktop_config.json:

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

Claude Code (CLI)

Файл .claude/mcp.json включен в репозиторий. Claude Code обнаружит его автоматически. Или добавьте вручную:

claude mcp add illustrator python3 -- -m illustrator

GitHub Copilot (VS Code)

Файл .vscode/mcp.json включен в репозиторий. VS Code (1.99+) обнаружит его автоматически. Или добавьте в свой settings.json:

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

🎯 Улучшенная система промптов

Этот MCP-сервер теперь включает продвинутую систему промптов, которая поможет вам создавать лучший контент! Используйте эти новые инструменты:

• get_prompt_suggestions — Получить категоризированные примеры промптов для разных типов контента

• get_system_prompt — Получить оптимальный системный промпт для ИИ-помощника

• get_prompting_tips — Получить советы по созданию более эффективных промптов

• get_advanced_template — Получить структурированные шаблоны для сложных дизайнерских задач

• help — Отобразить подробную справку и руководство

📚 Доступные категории промптов:

• 🎨 Базовые фигуры и геометрия

• 📝 Типографика и текст

• 🏢 Логотипы и брендинг

• 🌆 Иллюстрации и сцены

• 🎭 Иконки и элементы интерфейса

• 🎨 Художественные и творческие

• 📊 Графики и инфографика

• 🏷️ Печать и макеты

💡 Быстрый старт с промптами

Попробуйте спросить: «Дай мне предложения промптов для логотипов» или «Покажи советы по составлению промптов»

Подробные примеры и шаблоны см. в PROMPT_EXAMPLES.md

📋 Примеры промптов, которые я пробовал

Вот несколько промптов, которые я использовал, вместе с результатами, которые они сгенерировали:

• Промпт 1: Разработай чистый, минималистичный векторный арт маленькой кофейни во время дождя, с простым фасадом, лужами на улице и легкими серыми облаками в небе.

• Промпт 2: Создай иллюстрацию в акварельном стиле с изображением горизонта Мумбаи на закате.

• Промпт 3: Создай современный, минималистичный логотип для технологического стартапа под названием 'NeuraTech'.

(Результаты см. на прикрепленных изображениях!)

🍎 Примечания для macOS

• Adobe Illustrator должен быть установлен и запущен

• При первом использовании macOS запросит разрешение на автоматизацию — разрешите вашему терминалу/IDE управлять Illustrator

• Если вы видите ошибки «Application not running», сначала откройте Illustrator

• Скриншоты захватывают весь экран (Illustrator должен быть на переднем плане)

🪟 Примечания для Windows

• Adobe Illustrator должен быть установлен

• Требуется пакет pywin32 (устанавливается автоматически)

• Скрипты в Illustrator должны быть разрешены

📢 Участие в разработке

Пулл-реквесты приветствуются! Не стесняйтесь открывать тикеты с запросами функций, сообщениями об ошибках или предложениями.

Приятного творчества! 🌈💛