Illustrator Figure MCP

과학 그림을 편집 가능한 Adobe Illustrator 아트워크로 재구성하고, 그 결과가 구조적으로 올바른지 입증합니다.

macOS 전용입니다 (Illustrator는 macOS/Windows에서 실행되지만, 이 도구는 osascript → do javascript를 사용합니다). Adobe Illustrator와 Claude Code가 필요합니다.

왜 존재하는가

Illustrator에서 그림을 그릴 수 있는 MCP 서버는 많습니다. 하지만 그 서버들은 모델에게 손은 주었을지언정 눈은 주지 않습니다. 방금 그린 것이 올바른지 확인해 줄 무엇도 없기 때문입니다. 그래서 모델은 그리고, 성공했다고 보고하지만, 결과물에는 박스를 넘쳐 흐르는 텍스트, 아무 상관없는 직사각형 한가운데서 끝나는 화살표, 3pt씩 어긋난 "정렬된" 패널 세 개가 남게 됩니다.

가치가 있는 부분은 그리는 일이 아닙니다. 그건 서로 다른 부분을 검사하는 두 채널에서 이루어지는 검증 및 수리 루프입니다.

지오메트리는 증명하고 측정됩니다. 유사성은 판단대상입니다. 둘 중 어느 하나만으로는 충분하지 않습니다. — 트레이스만으로 지나치는 그림은 전혀 편집 가능하지 않은 상태에서도 모든 지오메트리는 검사를 통과하며, 보기만 좋은 렌더링은 구조에 대해 아무것도 말해 주지 않습니다.

audit_figure가 passed: true를 반환한다는 것은 하드 지오메트리 실패가 없다는 뜻입니다. 그림이 올바르다는 뜻은 아닙니다.

Related MCP server: Illustrator MCP Vectorizer

재구성하는 것, 트레이스하는 것이 아니다

트레이싱은 겉모습을 보존하고 의미를 파괴합니다. 이는 그림을 재구축한다는 목적의 본질을 무너뜨리는 것입니다. 세 가지 방어 장치가 지름길을 어렵게 만듭니다:

• 생성 시 시맨틱 태그. 모든 객체는 생성되는 즉시 UUID와 시맨틱 유형을 받기 때문에, 감사자는 새로 만들어진 객체와 외부 지오메트리를 구별할 수 있습니다.

• trace-signature. Image Trace의 expandTracing()은 무태그 경로 더미를 담은 무태그 그룹 하나를 남깁니다. 그런 그룹, 밀집된 무태그 경로, 그리고 선언된 하고자 하는 그리기를 초과하는 대량 지오메트리는 전부 하드 실패입니다.

• 래스터 게이트. place_image는 축소할 수 없음이 증명되지 않는 배치를 거부합니다.

래스터 게이트

유지되는 이미지는 다섯 가지를 모두 선언해야 하고, 단순히 기록되는 것이 아니라 검증됩니다:

검사는 감사자가 아니라 생성 경로에서 강제됩니다. 감사자만 확인하는 검사는 감사를 하지 않아도 그 뒤로 빠져나갈 수 있기 때문입니다.

커넥터

Illustrator에는 커넥터 기본 요소가 없습니다. 화살표는 특정 PathItem일 뿐이며, 그것이 가리키는 상자와 아무런 관계막 없습니다. 상자를 움직이면 화살표는 뒤에 남아 움직이지 않고 조용히 오류를 만들게 됩니다.

add_connector는 바인딩을 경로에 기록합니다. reflow_connectors는 객체의 현재 영역에서 지오메트리를 다시 계산합니다. audit_figure는 그려진 경로가 그 바인딩과 더 일치하지 않을 때 connector-detached를 보고합니다.

라우팅은 straight, orthogonal, 또는 curved입니다. curved는 부착 가장자리에 수직으로 출발하고 도착하는 베지어로, 전형적인 경로 다이어그램 스타일을 만들며 화살촉이 그 표적을 정확히 가리키는 것처럼 보이게 합니다. 감사기는 앵커 사이의 직선이 아닌 실제 커브를 샘플링하기 때문에, 잉크가의 위치가 있는 곳을 검사합니다.

연결된 객체를 이동 또는 크기 변경 하는 모든 작업 뒤에는 반드시 reflow_connectors가 뒤따라야 합니다. 화살촉은 Illustrator에 스크립트가 접근할 수 있는 arrowhead 속성이 없기 때문에 채워진 삼각형으로 그려집니다.

→ 전체 사용 가이드 — 설치, 핵심 규칙, 도구 레퍼런스, 두 가지 실제 예제, 그리고 감사 리포트 읽는 법.

설치

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은 가장 먼저 사용하는 도구입니다: 상자, 영역 텍스트 레이블, 바인딩된 커넥터 두 개까지 총 아홉 개의 객체를 만들고 감사하는 데 대략 750ms 소요됩니다. 개체 하나마다 한 번씩 호출하면 왕복 아홉 번이 걸릴 작업을 한 번으로 줄여줍니다.

문서

개발

npm test        # 245 tests, runs on any platform

코어 내에서 포팅된 지오메트리는 순수 ES3이므로, .jsx 모듈을 VM에 로드하고 Liang–Barsky 선분 교차 계산 등을 Illustrator 없이도 테스트합니다. Illustrator 작업을 걸지만은 macOS에서 실행한 상태로 테스트해야 합니다 — 깨지기 쉬운 제약 조건(ES3, UUID를 메타데이터보다 먼저 쓰는 순서, pageItems 스냅샷) 음은 CLAUDE.md를 참조하세요.

크레딧

• 도구 계층은 ie3jp/illustrator-mcp-server (MIT)에서 포크됨 — transport, JSX runner, UUID ID, note 메타데이터, 63개 Illustrator 도구. 자세한 것은 LICENSE를 보세요.

• 두 채널 검증 루프, 해당 감사 분류법, 그리고 네 가지 역할 프로토콜은 **icebird1998/scientific-illustrator**에서 포팅되었으며, 후자는 draw.io, PowerPoint, WPS용으로 구현합니다. 계산 수학은 백엔드 중추적이지만, 객체 모델은 그렇지 않습니다.

Adobe의 자회사가 아닙니다.