Illustrator MCP Server (Windows & macOS)

Illustrator MCP Serverへようこそ！🎨🚀

このプロジェクトでは、AIエージェントが自然言語のプロンプトを使用して、Adobe Illustrator内でベクターグラフィックを直接作成できます。ローカルのMCP（Model Context Protocol）サーバーを介してExtendScriptコマンドをIllustratorに送信することで動作します。

「雨の中の小さなコーヒーショップを描いて」のように、やりたいことを説明するだけで、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

1つのスクリプトで実行（クロスプラットフォーム）

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 - 包括的なヘルプとガイダンスを表示

📚 利用可能なプロンプトカテゴリ:

🎨 基本図形 & 幾何学
📝 タイポグラフィ & テキスト
🏢 ロゴ & ブランディング
🌆 イラスト & シーン
🎭 アイコン & UI要素
🎨 アート & クリエイティブ
📊 チャート & インフォグラフィック
🏷️ 印刷 & レイアウト

💡 プロンプトのクイックスタート

「ロゴのプロンプトの提案を教えて」や「プロンプトのヒントを表示して」と聞いてみてください

詳細な例とテンプレートについては、PROMPT_EXAMPLES.mdを参照してください

📋 試してみたサンプルプロンプト

私が使用したプロンプトと、それによって生成された結果の一部です：

プロンプト 1: 雨の中の小さなコーヒーショップのクリーンでミニマルなベクターアートをデザインしてください。シンプルな店構え、通りの水たまり、空に浮かぶ穏やかな灰色の雲を特徴としています。
プロンプト 2: 夕暮れ時のムンバイのスカイラインの水彩画風イラストを作成してください。
プロンプト 3: 「NeuraTech」というテック系スタートアップのための、モダンでミニマルなロゴを作成してください。

(結果については添付画像を参照してください！)

🍎 macOSに関する注意点

Adobe Illustratorがインストールされ、実行中である必要があります
初回使用時に、macOSから自動化の権限を求められます。ターミナル/IDEがIllustratorを制御できるように許可してください
「Application not running」というエラーが表示される場合は、先にIllustratorを開いてください
スクリーンショットはフルスクリーンをキャプチャします（Illustratorを最前面に表示してください）

🪟 Windowsに関する注意点

Adobe Illustratorがインストールされている必要があります
pywin32パッケージが必要です（自動的にインストールされます）
Illustratorのスクリプト機能が有効になっている必要があります

📢 コントリビューション

プルリクエストを歓迎します！機能リクエスト、バグ報告、提案などは、お気軽にIssueを作成してください。 Stars Forks License

楽しい制作を！ 🌈💛

Illustrator MCP Server