illustrator-mcp

Windows에서 Adobe Illustrator를 구동하는 MCP 서버입니다. COM 자동화(PowerShell의 New-Object -ComObject Illustrator.Application)를 통해 Illustrator와 통신하고, app.DoJavaScript를 통해 내부에서 ExtendScript(Illustrator의 JS 기반 스크립팅 언어)를 실행합니다. 네이티브 Node 애드온이나 Visual Studio 빌드 도구가 필요하지 않습니다. 모든 것은 Windows에 포함된 powershell.exe를 통해 처리됩니다.

요구 사항

• Adobe Illustrator가 설치된 Windows(Illustrator 2026 / 앱 버전 30.8에서 테스트됨).

• Node.js 18 이상.

Related MCP server: illustrator-mcp

설정

npm install
npm run build

Claude Code에 등록

claude mcp add illustrator-mcp -- node E:/Repositorios/illustrator-mcp/dist/index.js

(이후 Claude Code 세션을 다시 시작해야 새 서버를 인식합니다.)

도구

• illustrator_status — Illustrator에 연결(필요 시 실행)하고 열린 문서 목록을 표시합니다.

• illustrator_create_document — 새 문서 생성(포인트 단위의 너비/높이, RGB 또는 CMYK).

• illustrator_open_document — 기존 .ai/.eps/.pdf/.svg 파일을 엽니다.

• illustrator_save_document — 제자리에 저장하거나, 경로가 주어지면 다른 이름으로 저장합니다.

• illustrator_export_document — 활성 문서를 png/jpg/pdf/svg로 내보냅니다.

• illustrator_add_rectangle / illustrator_add_ellipse — 선택적 hex 채우기/선 색상으로 도형을 그립니다.

• illustrator_add_text — 포인트 텍스트 프레임을 추가합니다.

• illustrator_document_info — 활성 문서의 이름, 경로, 크기, 아트보드, 레이어를 표시합니다.

• illustrator_run_script — 탈출구: 임의의 ExtendScript를 실행하고 마지막 표현식의 값을 문자열로 반환합니다. 다른 도구가 다루지 않는 모든 것(선택, 레이어, 효과, 일괄 처리, Illustrator의 전체 객체 모델)에 이 도구를 사용하세요.

도형/텍스트의 모든 좌표는 포인트 단위이며 아트보드의 왼쪽 위에서 측정됩니다(도구는 내부적으로 Illustrator의 기본 좌표계인 왼쪽 아래 원점 좌표계로 변환합니다).

작동 방식

각 도구 호출은 작은 ExtendScript 스니펫을 렌더링하고, 이를 임시 .jsx 파일에 작성한 다음 scripts/run-illustrator.ps1로 셸 아웃합니다. 이 스크립트는 COM을 통해 Illustrator에 연결하고 $.evalFile(...)로 해당 파일을 평가합니다. 스크립트의 반환 값(마지막 표현식)은 도구의 텍스트 출력으로 돌아옵니다. ExtendScript 내부에서 발생한 오류는 브리지를 중단시키는 대신 포착되어 도구 오류로 표시됩니다.