Illustrator MCP 서버 (Windows & macOS)

Illustrator MCP 서버에 오신 것을 환영합니다! 🎨🚀

이 프로젝트를 통해 AI 에이전트가 자연어 프롬프트를 사용하여 Adobe Illustrator 내에서 벡터 그래픽을 직접 생성할 수 있습니다. 이 서버는 로컬 MCP(Model Context Protocol) 서버를 통해 Illustrator로 ExtendScript 명령을 전송하는 방식으로 작동합니다.

*"비 오는 날의 작은 커피숍을 그려줘"*와 같이 원하는 것을 간단히 설명하기만 하면 Illustrator가 이를 현실로 만들어준다고 상상해 보세요!

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

✨ 주요 기능

AI 프롬프트를 사용하여 프로그래밍 방식으로 Adobe Illustrator 제어
ExtendScript (.jsx) 스크립트를 Illustrator로 직접 전송
Illustrator 창의 스크린샷 캡처
오픈 소스 및 경량화
크로스 플랫폼: Windows & macOS 지원
멀티 클라이언트: Claude Desktop, Claude Code, Cursor, VS Code Copilot, JetBrains Copilot과 호환

💻 설치 방법

사전 요구 사항

Python 3.12+ — Python 다운로드
Adobe Illustrator 설치 및 실행 중
macOS 전용: 메시지가 표시되면 자동화 권한 부여 (시스템 설정 → 개인정보 보호 및 보안 → 자동화)

1. 저장소 복제

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

2. 가상 환경 생성

macOS / Linux:

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

Windows:

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

3. 의존성 설치

pip install -r requirements.txt

macOS에서는 pywin32가 자동으로 건너뜁니다. 추가적인 macOS 패키지는 필요하지 않습니다.

4. MCP 서버 시작 (수동 / 디버그 모드)

python -m illustrator

단일 스크립트로 실행 (크로스 플랫폼)

bash run_server.sh

이 스크립트는 플랫폼을 자동으로 감지하고, .venv를 생성하며, 의존성을 설치하고 서버를 시작합니다.

🔌 클라이언트 구성

이 서버는 stdio 전송을 사용하며, 모든 주요 MCP 클라이언트와 호환됩니다.

중요: 클라이언트를 통해 사용할 때는 서버를 수동으로 시작하지 마십시오. 클라이언트가 자동으로 서버 프로세스를 시작하고 관리합니다.

Claude Desktop

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

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

Windows — %APPDATA%\Claude\claude_desktop_config.json 편집:

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

Claude Code (CLI)

.claude/mcp.json이 저장소에 포함되어 있습니다. Claude Code가 자동으로 감지합니다. 또는 수동으로 추가하세요:

claude mcp add illustrator python3 -- -m illustrator

GitHub Copilot (VS Code)

.vscode/mcp.json이 저장소에 포함되어 있습니다. VS Code (1.99+)가 자동으로 감지합니다. 또는 settings.json에 추가하세요:

{
  "mcp": {
    "servers": {
      "illustrator": {
        "type": "stdio",
        "command": "python3",
        "args": ["-m", "illustrator"]
      }
    }
  }
}

🎯 향상된 프롬프트 시스템

이 MCP 서버에는 더 나은 콘텐츠를 만들 수 있도록 돕는 고급 프롬프트 시스템이 포함되어 있습니다! 다음 새로운 도구들을 사용해 보세요:

get_prompt_suggestions - 다양한 콘텐츠 유형에 대한 카테고리별 프롬프트 예시 가져오기
get_system_prompt - AI 안내를 위한 최적의 시스템 프롬프트 가져오기
get_prompting_tips - 더 효과적인 프롬프트를 만들기 위한 팁 가져오기
get_advanced_template - 복잡한 디자인 작업을 위한 구조화된 템플릿 가져오기
help - 포괄적인 도움말 및 안내 표시

💡 프롬프트 빠른 시작

다음과 같이 질문해 보세요: "로고를 위한 프롬프트 제안을 해줘" 또는 "프롬프트 작성 팁을 알려줘"

자세한 예시와 템플릿은 PROMPT_EXAMPLES.md를 참조하세요.

📋 테스트해 본 샘플 프롬프트

다음은 제가 사용해 본 몇 가지 프롬프트와 그 결과물입니다:

프롬프트 1: 비 오는 날의 작은 커피숍을 깔끔하고 미니멀한 벡터 아트로 디자인해줘. 단순한 상점 정면, 거리의 물웅덩이, 하늘의 부드러운 회색 구름을 포함해줘.
프롬프트 2: 일몰 때의 뭄바이 스카이라인을 수채화 스타일 일러스트로 만들어줘.
프롬프트 3: 'NeuraTech'라는 기술 스타트업을 위한 현대적이고 미니멀한 로고를 만들어줘.

(결과물은 첨부된 이미지를 확인하세요!)

🍎 macOS 참고 사항

Adobe Illustrator가 설치되어 있고 실행 중이어야 합니다.
처음 사용할 때 macOS에서 자동화 권한을 요청합니다. 터미널/IDE가 Illustrator를 제어할 수 있도록 허용해 주세요.
"Application not running" 오류가 발생하면 Illustrator를 먼저 여세요.
스크린샷은 전체 화면을 캡처합니다 (Illustrator가 전면에 있어야 합니다).

🪟 Windows 참고 사항

Adobe Illustrator가 설치되어 있어야 합니다.
pywin32 패키지가 필요합니다 (자동으로 설치됨).
Illustrator 스크립팅이 활성화되어 있어야 합니다.

📢 기여하기

풀 리퀘스트는 언제나 환영합니다! 기능 요청, 버그 신고 또는 제안 사항이 있으면 언제든 이슈를 열어주세요. Stars Forks License

즐거운 창작 되세요! 🌈💛

Illustrator MCP Server