Illustrator Figure MCP

Воссоздавайте научные рисунки как редактируемые иллюстрации Adobe Illustrator и докажите, что результат структурно корректен.

Только macOS (Illustrator работает на macOS/Windows; здесь используется osascript → do javascript). Требуются Adobe Illustrator и Claude Code.

Зачем это существует

Многие MCP-серверы умеют рисовать в Illustrator. Они дают модели руки, но не глаза: ничто не проверяет, правильно ли нарисовано то, что она только что создала. Поэтому модель рисует, сообщает об успехе, а на рисунке подпись вылезает за рамку, стрелка заканчивается посреди постороннего прямоугольника, а три «выровненные» панели сдвинуты на 3 пункта.

Ценность не в самом рисовании. Ценность — в цикле проверки и исправления, работающем по двум каналам, которые проверяют разные вещи:

Геометрия доказывается. Сходство оценивается. Ни того, ни другого по отдельности недостаточно — трассированный рисунок проходит все геометрические проверки, оставаясь полностью нередактируемым, а красивый рендер ничего не говорит о структуре.

Возврат passed: true от audit_figure означает отсутствие жёстких геометрических ошибок. Это не означает, что рисунок корректен.

Related MCP server: Illustrator MCP Vectorizer

Воссоздавайте, а не трассируйте

Трассировка сохраняет внешний вид, но уничтожает семантику — а именно в этом и состоит смысл пересоздания рисунка. Три защиты затрудняют этот короткий путь:

• Семантическая маркировка при создании. Каждый объект получает UUID и семантический тип в момент создания, поэтому аудитор может отличить сконструированные объекты от посторонней геометрии.

• trace-signature. expandTracing() из Image Trace создаёт одну немаркированную группу с кучей немаркированных путей; это, а также плотные немаркированные пути и объёмная геометрия, превышающая заявленный журнал рисования, — всё это жёсткие ошибки.

• Растровый шлюз. place_image отказывается от любого размещения, которое не является доказуемо неразложимым.

Растровый шлюз

Каждое сохранённое изображение должно декларировать все пять пунктов, и они проверяются, а не просто записываются:

Контроль осуществляется на пути создания, а не в аудиторе: проверка, выполняемая только аудитором, обходится тем, что аудит просто не запускают.

Соединители

В Illustrator нет примитива «соединитель». Стрелка — это PathItem, и у неё нет связи с рамкой, на которую она указывает: переместите рамку — стрелка останется на месте, молча и неверно.

add_connector записывает привязку (источник, цель, точки крепления) на пути. reflow_connectors заново решает геометрию на основе текущих границ объектов. audit_figure сообщает connector-detached, когда нарисованный путь больше не согласуется со своей привязкой.

Маршрутизация бывает straight, orthogonal или curved — кривая Безье, которая выходит и приходит перпендикулярно к рёбрам крепления; это стандартный вид диаграмм потоков, и наконечники стрелок читаются как направленные прямо в цель. Аудитор сэмплирует фактическую кривую, а не хорду между якорями, поэтому проверяет, где именно находится чернила.

Любая операция, которая перемещает или изменяет размер связанного объекта, должна сопровождаться reflow_connectors. Наконечники стрелок рисуются как закрашенные треугольники, поскольку Illustrator не предоставляет свойство наконечника для скриптов.

→ Полное руководство по использованию — установка, основные правила, справочник инструментов, два рабочих примера и как читать отчёт аудита.

Установка

npm install && npm run build

Добавьте его в Claude Code:

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

Предоставьте разрешение Automation при первом запуске инструмента: Системные настройки → Конфиденциальность и безопасность → Автоматизация → Claude → Adobe Illustrator.

Установите четыре ролевых навыка:

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

Четыре роли

Попросите Claude «воссоздать этот рисунок в Illustrator» с эталонным изображением, и recreate-scientific-figure координирует цикл:

Каждая область должна пройти проверку, прежде чем начнётся следующая; затем весь рисунок проходит тот же цикл.

Инструменты, добавленные этим форком

Плюс растровый шлюз на place_image и семантическая маркировка на каждом инструменте create_*. Остальные 66 инструментов — из апстрима (всего 71).

draw_sequence — то, что нужно: девять объектов — рамки, текстовые подписи, два связанных соединителя — строятся и проверяются примерно за 750 мс, тогда как по одному вызову на объект потребовалось бы девять циклов.

Документация

Разработка

npm test        # 245 tests, runs on any platform

Перенесённая геометрия — чистый ES3, поэтому модули .jsx загружаются в VM, а математика Ляна–Барски и пересечения сегментов тестируется без Illustrator. Всё, что касается Illustrator, должно тестироваться на macOS с запущенным Illustrator — см. CLAUDE.md о ограничениях, которые легко нарушить (ES3, порядок UUID-до-метаданных, снимки pageItems).

Благодарности

• Слой инструментов форкнут из ie3jp/illustrator-mcp-server (MIT) — транспорт, раннер JSX, UUID-идентичность, метаданные note и 63 инструмента Illustrator. См. LICENSE.

• Двухканальный цикл проверки, таксономия аудита и протокол четырёх ролей перенесены из icebird1998/scientific-illustrator, который реализует их для draw.io, PowerPoint и WPS. Математика не зависит от бэкенда; объектная модель — зависит.

Не аффилирован с Adobe.