Illustrator Figure MCP
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: visualspec
Воссоздавайте, а не трассируйте
Трассировка сохраняет внешний вид, но уничтожает семантику — а именно в этом и состоит смысл пересоздания рисунка. Три защиты затрудняют этот короткий путь:
Семантическая маркировка при создании. Каждый объект получает UUID и семантический тип в момент создания, поэтому аудитор может отличить сконструированные объекты от посторонней геометрии.
trace-signature.expandTracing()из Image Trace создаёт одну немаркированную группу с кучей немаркированных путей; это, а также плотные немаркированные пути и объёмная геометрия, превышающая заявленный журнал рисования, — всё это жёсткие ошибки.Растровый шлюз.
place_imageотказывается от любого размещения, которое не является доказуемо неразложимым.
Растровый шлюз
Каждое сохранённое изображение должно декларировать все пять пунктов, и они проверяются, а не просто записываются:
Декларация | Требование |
| конкретное описание неразложимого пиксельного содержимого — «image», «PNG», «screenshot» отклоняются |
|
|
|
|
|
|
| ≥ 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 координирует цикл:
Навык | Роль |
| Дизайнер — создаёт спецификацию реконструкции до начала рисования |
| Рисовальщик + оркестратор — строит область за цикл, запускает шлюзы |
| Рецензент — читает оба канала доказательств, выдаёт замечания |
| Исправитель — превращает замечания в упорядоченные операции на уровне объектов |
Каждая область должна пройти проверку, прежде чем начнётся следующая; затем весь рисунок проходит тот же цикл.
Инструменты, добавленные этим форком
Инструмент | Назначение |
| детерминированный структурный аудит; каждое замечание несёт доказательство, исправление и критерий приёмки |
| построение целой области за один цикл, с возможным аудитом в том же вызове |
| создание соединителя, привязанного к двум объектам по имени |
| повторное решение геометрии соединителей после перемещения объектов |
| устранение переполнения текстовой области — изменение размера рамки через |
Плюс растровый шлюз на 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.
This server cannot be deployed
Maintenance
Related MCP Connectors
Create and edit scientific figures, generate data charts, and export editable SVG and PowerPoint.
Compose multi-panel scientific figures for 16 journals - aligned axes, print-ready exports.
81Traceable scientific novelty and evidence assessment with source-linked results and a human gate.
Create and revise diagrams, charts, PowerPoint presentations and research workflows.
1
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceMCP 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
- AlicenseNot gradedqualityBmaintenanceEnables 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 npmApache 2.0
- AlicenseNot gradedqualityAmaintenanceConverts 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.4Apache 2.0
- AlicenseNot gradedqualityAmaintenanceEnables 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