Skip to main content
Glama
ymo6

Illustrator Figure MCP

by ymo6

Illustrator Figure MCP

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

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

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

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

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

Канал

Механизм

Что доказывает

Геометрия

audit_figure — детерминированная, только чтение

внутренняя корректность: вхождение, вырожденные размеры, дублирующиеся имена, переполненный текст, растровые декларации, маршрутизация и привязки соединителей, выравнивание повторяющихся серий, сигнатуры трассировки

Внешний вид

export в PNG, сравнение с эталонным кадром

сходство

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

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

Related MCP server: visualspec

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

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

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

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

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

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

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

Декларация

Требование

raster_reason

конкретное описание неразложимого пиксельного содержимого — «image», «PNG», «screenshot» отклоняются

source_is_tightly_cropped

true — все границы, подписи, стрелки, легенды, оси и соседние панели обрезаны

atomic_raster_unit

true — один неделимый элемент данных, а не сетка или монтаж

contains_reconstructable_content

false — внутри не осталось ничего, что должно быть редактируемым объектом

decomposition_note

≥ 8 символов: что было выделено и пересоздано

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

Соединители

В 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 координирует цикл:

Навык

Роль

design-scientific-figure

Дизайнер — создаёт спецификацию реконструкции до начала рисования

recreate-scientific-figure

Рисовальщик + оркестратор — строит область за цикл, запускает шлюзы

audit-scientific-figure

Рецензент — читает оба канала доказательств, выдаёт замечания

correct-scientific-figure

Исправитель — превращает замечания в упорядоченные операции на уровне объектов

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

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

Инструмент

Назначение

audit_figure

детерминированный структурный аудит; каждое замечание несёт доказательство, исправление и критерий приёмки

draw_sequence

построение целой области за один цикл, с возможным аудитом в том же вызове

add_connector

создание соединителя, привязанного к двум объектам по имени

reflow_connectors

повторное решение геометрии соединителей после перемещения объектов

fit_text

устранение переполнения текстовой области — изменение размера рамки через modify_object не перекомпоновывает его

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

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

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

docs/USAGE.md

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

CLAUDE.md

Внутреннее устройство и ограничения, которые легко нарушить, для всех, кто редактирует этот репозиторий

skills/

Четыре ролевых навыка

Разработка

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.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    B
    maintenance
    MCP 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
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables 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.
    15 npm
    Apache 2.0
  • A
    license
    Not graded
    quality
    A
    maintenance
    Converts 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.
    4
    Apache 2.0
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables 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