일러스트레이터 MCP 서버에 오신 것을 환영합니다! 🎨🚀

이 프로젝트는 AI 에이전트가 자연어 프롬프트를 사용해 Adobe Illustrator 내에서 벡터 그래픽을 **직접 생성할 수 있게 합니다.
이 프로토콜은 로컬 MCP(모델 컨텍스트 프로토콜) 서버를 통해 ExtendScript 명령을 Illustrator에 전송하는 방식으로 작동합니다.

원하는 것을 단순히 묘사하는 것만 상상해 보세요 — 예를 들어 “비 오는 날 작은 커피숍을 그리기” — 일러스트레이터가 그것을 생생하게 구현해 줍니다!

Windows(COM 자동화)와 macOS(AppleScript/osascript)에서 작동합니다.

---

✨ 특징

• AI 프롬프트를 이용해 Adobe Illustrator를 프로그래밍적으로 제어함
• ExtendScript(.jsx) 스크립트를 Illustrator로 직접 전송하기
• 일러스트레이터 창 스크린샷 캡처
• 오픈 소스 및 경량
• 크로스 플랫폼: 윈도우 및 macOS
• 멀티 클라이언트: Claude Desktop, Claude Code, 커서, VS Code Copilot, JetBrains Copilot과 함께 동작

---

💻 설치

전제 조건

• Python 3.12+ — Python 다운로드
• Adobe Illustrator 설치 및 실행 중
• macOS 전용: 알림 시 자동화 권한 부여 (시스템 설정 → 프라이버시 및 보안 → 자동화)

1. 저장소 복제

2. 가상 환경 만들기

macOS / Linux:

윈도우:

Illustrator MCP Server (Windows & macOS)

Welcome to the Illustrator MCP Server! 🎨🚀

This project allows AI agents to directly create vector graphics inside Adobe Illustrator using natural language prompts.
It works by sending ExtendScript commands to Illustrator via a local MCP (Model Context Protocol) server.

Imagine simply describing what you want — like “draw a small coffee shop during rain” — and Illustrator brings it to life!

Works on Windows (COM automation) and macOS (AppleScript/osascript).

---

✨ Features

• Control Adobe Illustrator programmatically using AI prompts
• Send ExtendScript (.jsx) scripts directly to Illustrator
• Capture screenshots of the Illustrator window
• Open-source and lightweight
• Cross-platform: Windows & macOS
• Multi-client: Works with Claude Desktop, Claude Code, Cursor, VS Code Copilot, and JetBrains Copilot

---

💻 Installation

Prerequisites

• Python 3.12+ — Download Python
• Adobe Illustrator installed and running
• macOS only: Grant Automation permissions when prompted (System Settings → Privacy & Security → Automation)

1. Clone the repository

git clone https://github.com/krVatsal/illustrator-mcp.git
cd illustrator-mcp

2. Create a virtual environment

macOS / Linux:

python3 -m venv .venv
source .venv/bin/activate

Windows:

python -m venv .venv
.\.venv\Scripts\activate

3. Install dependencies

pip install -r requirements.txt

On macOS, pywin32 is automatically skipped. No extra macOS packages required.

4. Start the MCP Server (manual / debug mode)

python -m illustrator

Run with one script (cross-platform)

bash run_server.sh

This script auto-detects your platform, creates a .venv, installs dependencies, and starts the server.

---

🔌 Client Configuration

The server uses stdio transport — compatible with all major MCP clients.

Important: Do NOT start the server manually when using it through a client. The client starts and manages the server process automatically.

Claude Desktop

macOS — edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "illustrator": {
      "command": "/path/to/illustrator-mcp/.venv/bin/python3",
      "args": ["-m", "illustrator"]
    }
  }
}

Windows — edit %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "illustrator": {
      "command": "C:\\Users\\\\illustrator-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m", "illustrator"]
    }
  }
}

Claude Code (CLI)

A .claude/mcp.json is included in the repo. Claude Code will auto-detect it. Or add manually:

claude mcp add illustrator python3 -- -m illustrator

GitHub Copilot (VS Code)