illustrator-mcp-server

🇺🇸 English | 🇯🇵 日本語 | 🇨🇳 简体中文 | 🇰🇷 한국어 | 🇪🇸 Español | 🇩🇪 Deutsch | 🇫🇷 Français | 🇵🇹 Português (BR)

🇯🇵 日本語の README は README.ja.md にあります。

Illustrator MCP Server

Adobe Illustrator のデザインデータを読み取り、操作、書き出しするための MCP（Model Context Protocol） サーバーです。66 種類の組み込みツールを備えています。

Claude などの AI アシスタントから Illustrator を直接操作できます。Web 実装用にデザイン情報を抽出したり、印刷用データを確認したり、アセットを書き出したりできます。

Adobe 公式の Illustrator MCP（ベータ版）でできることをすべて実行でき、さらに多くの機能を備えています。比較をご覧ください。

メモ

Claude の拡張機能ディレクトリおよびプラグインマーケットプレイスでは、このプロジェクトは Design Bridge by IE3 として掲載されています。Anthropic のディレクトリでは、掲載名に他社のブランド名を使用できないため、掲載名が異なりますが、プロジェクト自体は同じで、npm パッケージ名も引き続き illustrator-mcp-server です。以前の名前（illustrator@ie3jp-illustrator）で Claude Code プラグインをインストールした場合は、再インストール方法について Claude Code をご覧ください。

🎨 ギャラリー

以下の作品はすべて、手作業で Illustrator を操作することなく、Claude との自然言語での会話だけで制作されました。

イベントポスター	ロゴ案
名刺	Twilight Geometry

プロンプト、ツールの使用方法、アートボードの構成については、以下の詳細な解説をご覧ください。

ヒント

このツールの開発と保守には、時間とリソースが必要です。 ワークフローに役立っている場合は、ご支援いただけると大変励みになります。☕ コーヒーをごちそうしてください！

🚀 クイックスタート

🛠️ Claude Code

Node.js 20+ が必要です。

claude mcp add illustrator-mcp -- npx illustrator-mcp-server

または、MCP サーバーとプリプレス用プリフライトスキルをまとめたプラグインとしてインストールできます（Claude Cowork でも動作します）。

/plugin install ie3-design-bridge --marketplace ie3jp/illustrator-mcp-server

v2.1.275 より前の Claude Code を使用している場合は、先にマーケットプレイスを追加してください。

/plugin marketplace add ie3jp/illustrator-mcp-server
/plugin install ie3-design-bridge@ie3

すでに claude mcp add でサーバーを追加している場合は、二重起動を防ぐため、先に削除してください（claude mcp remove illustrator-mcp）。

🖥️ Claude Desktop

1. GitHub Releases から illustrator-mcp-server.mcpb をダウンロードします
2. Claude Desktop を開き、Settings → Extensions を選択します
3. .mcpb ファイルを Extensions パネルにドラッグ＆ドロップします
4. Install ボタンをクリックします

{
  "mcpServers": {
    "illustrator": {
      "command": "npx",
      "args": ["illustrator-mcp-server"]
    }
  }
}

注意

AI は誤りを犯すことがあります。出力を過信せず、提出データは必ず人間が最終確認してください。結果に対する責任はユーザーにあります。

メモ

macOS： 初回起動時に、「システム設定」>「プライバシーとセキュリティ」>「オートメーション」でアクセスを許可してください。

メモ

ほとんどの変更系ツールは、実行中に Illustrator を前面に表示します。読み取り系ツールと export はアプリを切り替えずに実行されます。export_pdf は、日本語のトンボを描画する場合にのみ Illustrator を前面に表示します。

メモ

ファイルはデフォルトで保護されています。 close_document は、明示的に選択しない限り（save: false）、未保存の変更を破棄しません。また、export、export_pdf、save_document（別名で保存）、extract_design_tokens は、overwrite: true を設定しない限り既存のファイルを置き換えません。必要な場合は、Claude に「保存せずに閉じて」または「ファイルを上書きして」と伝えてください。

複数バージョンの Illustrator

Illustrator を複数バージョンインストールしている場合、会話中に使用するバージョンを Claude に指定できます。「Illustrator 2024 を使って」のように伝えると、set_illustrator_version ツールがそのバージョンを対象にします。

対応バージョン： Illustrator 2024（v28）以降で動作確認済みです。Illustrator 2020～2023（v24～v27）は、サーバーが使用する ExtendScript API がすべて v24 から存在するため動作する見込みですが、動作確認はされていないため、これらのバージョンでツールを実行すると警告が表示されます。2020（v24）より前のバージョンは拒否されます。未確認のバージョンで問題が発生した場合は、issue を作成してください。

メモ

Illustrator がすでに起動している場合、バージョン設定に関係なく、サーバーは起動中のインスタンスに接続します。バージョン設定は、Illustrator がまだ起動していないときに正しいバージョンを起動するためだけに使用されます。

環境変数

1 回の呼び出しにデフォルト値を超える時間が必要な場合は、値を大きくしてください。たとえば、import_svg_as_editable で大きな SVG（100 個以上のオブジェクト）を読み込む場合や、大きなドキュメントで get_document_structure ／ export_pdf を実行する場合です。

値はミリ秒単位の正の整数である必要があります。それ以外の値（0、負の数、数値以外の文字列、または 2147483647 を超える値）はデフォルト値に戻ります。値はサーバーの起動時に一度だけ読み込まれます。

{
  "mcpServers": {
    "illustrator": {
      "command": "npx",
      "args": ["illustrator-mcp-server"],
      "env": {
        "ILLUSTRATOR_MCP_TIMEOUT_NORMAL": "60000",
        "ILLUSTRATOR_MCP_TIMEOUT_HEAVY": "180000"
      }
    }
  }
}

🎬 できること

You:    Show me all the text information in this document
Claude:  → list_text_frames → get_text_frame_detail
         There are 12 text frames in the document.
         The heading "My Design" uses Noto Sans JP Bold 48px, color #333333 ...

You:    Run a pre-press preflight check
Claude:  → preflight_check
         ⚠ 2 warnings:
         - Low resolution image: image_01.jpg (150dpi) — 300dpi or higher recommended
         - Non-outlined fonts: 3 text frames

You:    Check text for inconsistencies
Claude:  → check_text_consistency
         📝 Consistency Report:
         ⚠ "Contact Us" vs "Contact us" — capitalization mismatch
         ❌ "Lorem ipsum" (2 places) — placeholder text remaining

You:    Create banner size variations from this A4 flyer
Claude:  → get_document_info → resize_for_variation
         Created 3 size variations:
         - 728×90 / 300×250 / 160×600

🆚 Adobe 公式 Illustrator MCP との比較

簡単に言うと、公式 MCP でできることはすべてこのプロジェクトでもでき、それに加えてさらに多くのことができます。 Adobe は、既存ドキュメントの分析と一括処理に重点を置いた組み込み MCP サーバーを Illustrator Beta（30.4 以降。2026 年 8 月時点ではまだベータ版のみ）で提供しています。このプロジェクトでは、分析、一括再配色、バリエーション、アートボードの一括書き出し、フォント／リンク切れのチェックといった同じワークフローに対応し、さらに公式サーバーにはない機能、つまりアートワークの新規作成、ドキュメントの保存、印刷・プリプレスチェック、デザインシステム用ツールも備えています。また、ベータ版を必要とせず、安定版の Illustrator で動作します。

* 2026 年 4 月時点のユーザー報告に基づいています（ベータ版）。公式サーバーは現在も積極的に開発されています。最新の状況についてはAdobe のドキュメントをご覧ください。

📖 レシピ

You:    Summarize the colors and typography in this design

Claude:  → get_colors → list_text_frames → get_text_frame_detail

         ■ Color Palette
         - Primary: #1A73E8 (CMYK: 85,50,0,0)
         - Secondary: #34A853
         - Text: #202124
         - Background: #FFFFFF

         ■ Typography
         - Headings: Noto Sans JP Bold / 32px
         - Body: Noto Sans JP Regular / 16px / line-height: 1.75
         - Captions: Noto Sans JP Medium / 12px

You:    Export all artboards as SVG with outlined text

Claude:  → get_artboards → convert_to_outlines → export (repeated)

         Exported 4 artboards:
         - /output/header.svg
         - /output/hero.svg
         - /output/feature.svg
         - /output/footer.svg

You:    Check if this document is PDF/X-1a compliant

Claude:  → preflight_check (target_pdf_profile: "x1a")

         ❌ PDF/X-1a compliance errors:
         - Transparency on 3 objects (X-1a prohibits transparency)
         - RGB colors found in 2 places (X-1a requires CMYK/spot only)

         ⚠ Warnings:
         - 5 non-outlined fonts (embedding recommended)
         - Image "photo_02.jpg" at 150dpi (300dpi recommended)

You:    Check placed image quality for print

Claude:  → get_images (include_print_info: true)

         ■ Image Quality Report:
         ✅ hero.psd — CMYK, 350ppi effective
         ⚠ icon_set.png — RGB (mismatch with CMYK document), 300ppi effective
         ❌ photo_bg.jpg — CMYK, 72ppi effective (over-enlarged)
           → Replace with a 300dpi+ image at actual size

You:    Check text contrast ratios

Claude:  → check_contrast (auto_detect: true)

         ■ WCAG Contrast Report:
         ❌ "Caption" on "light gray" — 2.8:1 (AA fail)
         ⚠ "Subheading" on "white" — 4.2:1 (AA Large OK, AA Normal fail)
         ✅ "Body text" on "white" — 12.1:1 (AAA pass)

ワークフローテンプレート

Claude Desktop のプロンプト選択メニューで利用できる、事前に作成されたワークフローテンプレートです。

ツールリファレンス

読み取りツール（21）

書き出しツール（2）

座標系

サーバーはドキュメントから座標系を自動検出します。

• CMYK ドキュメントでは、印刷デザイナーが期待する座標系に一致する、Illustrator のネイティブ座標系を使用します
• RGB ドキュメントでは、AI が扱いやすい Web 形式の座標系を使用します
• 必要に応じて set_workflow を使い、自動検出された座標系を上書きします
• すべてのツールの応答には、有効な座標系を示す coordinateSystem フィールドが含まれます
• 自動検出に失敗した場合、ツールは推測せずにエラーを返します。coordinate_system を明示的に渡すか、set_workflow を呼び出してください

例：SMPTE テストパターン

Claude への自然言語による指示だけで作成した、1920×1080 の SMPTE カラーバーテストパターンです。

プロンプト：

1920x1080 のビデオテストパターンを作成してください

結果：

アートボードの構成（get_document_structure を使用）：

Labels
├── title-safe-label        (text)    — "TITLE SAFE (10%)"
├── action-safe-label       (text)    — "ACTION SAFE (5%)"
├── credit-label            (text)    — "Generated by illustrator-mcp-server"
├── test-label              (text)    — "SMPTE COLOR BARS — TEST PATTERN"
├── format-label            (text)    — "Full HD — 16:9"
└── resolution-label        (text)    — "1920 x 1080"

Center Cross
├── title-safe              (path)    — 1536×864 stroke rectangle
├── action-safe             (path)    — 1728×972 stroke rectangle
├── cross-circle            (path)    — 150×150 center circle
├── cross-v                 (path)    — vertical crosshair
└── cross-h                 (path)    — horizontal crosshair

Color Bars
├── pluge-black … pluge-navy   (path ×9)  — PLUGE / grayscale bottom strip
├── rev-white … rev-blue       (path ×7)  — reverse color middle strip
└── bar-white … bar-blue       (path ×7)  — 75% SMPTE color bars

使用したツール：create_document、manage_layers、create_rectangle ×23、create_line ×2、create_ellipse、create_text_frame ×6、modify_object ×4、save_document、export

例：トワイライト・ジオメトリー

抽象的な幾何学的風景のアートワークです。「好きなアートを自由に作って」という指示以外、人間によるデザインの指示はなく、すべて Claude が作成しました。

プロンプト：

Illustrator で、あなたの想像力を生かした作品を作ってください。時間をかけて、好きなものを自由に作成してください。

Claude の制作過程：

「トワイライト・ジオメトリー」を作成します。幾何学的な天体を取り入れた抽象的な風景です。深いグラデーションの黄昏の空、幾重にも重なる山のシルエット、装飾的な輪をまとった三日月、キャンバスに散りばめられた星を描きます。

色とりどりのひし形の星を描きます。温かみのある白、涼しげな青、ラベンダーのような紫など、星の種類の違いを表現するために、それぞれに微妙な変化をつけます。星座の線で星々をつなぎます。神秘的な雰囲気を出すため、空にはワイヤーフレームの三角形と六角形を浮かべます。

下部には水面を描き、月の光をきらめく波線で反射させ、下に向かって薄く消えていくようにします。

Claude の感想：

期待していたよりも良い作品になりました。幾何学と自然が融合した世界をうまく表現できたと思います。

結果：

使用したツール：create_document、manage_layers ×4、create_rectangle ×2、create_gradient ×2、create_path ×11、create_ellipse ×14、create_line ×4、create_text_frame ×2、modify_object、set_z_order、export

既知の制限事項

開発者向け

アーキテクチャ

flowchart LR
    Claude <-->|MCP Protocol| Server["MCP Server\n(TypeScript/Node.js)"]

    Server -.->|generate| Runner["run-{uuid}.scpt / .ps1"]
    Server -.->|generate| JSX["script-{uuid}.jsx\n(BOM UTF-8)"]
    Server -.->|write| PF["params-{uuid}.json"]

    Runner -->|execFile| osascript
    Runner -->|execFile| PS["powershell.exe"]

    osascript -->|do javascript| AI["Adobe Illustrator\n(ExtendScript/JSX)"]
    PS -->|DoJavaScript| AI

    JSX -.->|execute| AI
    PF -.->|read| AI
    AI -.->|write| RF["result-{uuid}.json"]
    RF -.->|read| Server

ソースからのビルド

git clone https://github.com/ie3jp/illustrator-mcp-server.git
cd illustrator-mcp-server
npm install
npm run build
claude mcp add illustrator-mcp -- node /path/to/illustrator-mcp-server/dist/index.js

検証

npx @modelcontextprotocol/inspector npx illustrator-mcp-server

テスト

# Unit tests
npm test

# E2E smoke test (requires Illustrator running)
npm run build   # E2E runs dist/index.js
npx tsx test/e2e/e2e-test.ts        # every tool (192 cases)
npx tsx test/e2e/e2e-behaviors.ts   # behavior & regression checks (91 cases)
npx tsx test/e2e/e2e-cmyk-only.ts
npx tsx test/e2e/svg-import-test.ts

E2E テストスイートは独自のドキュメントを作成し、ほかの開いているドキュメントには一切触れず、保存せずに閉じます。e2e-test.ts は、登録されているすべてのツールをテストします（RGB と CMYK、座標系の自動検出）。e2e-behaviors.ts は、実際のアプリで満たされるべき動作を確認します。メモが保持されること、一部の処理に失敗した場合に報告されること、ファイルが上書きされないこと、トンボと PDF の書き出しによって作品が変更されないことを検証します。

プライバシーポリシー

illustrator-mcp-server はすべてお使いのコンピューター上で実行されます。個人データを収集せず、テレメトリーもなく、独自にネットワーク接続を行うこともありません。ツールのパラメーターとドキュメントデータは、ローカルの Illustrator と、そのツールを呼び出した MCP クライアントとの間でのみやり取りされます。一時ファイルは呼び出しごとに削除されます。詳細はプライバシーポリシーをご覧ください。

免責事項

このツールは多くの Illustrator 操作を自動化しますが、AI は誤りを犯すことがあります。抽出されたデータ、プリフライトの結果、ドキュメントへの変更は、必ず人が確認してください。品質チェックをこのツールだけに頼らないでください。 特に印刷物の入稿やクライアントへの納品物については、ご自身での手動確認と併せてアシスタントとしてご利用ください。本ソフトウェアまたはその出力の使用によって生じた損害や損失について、作者は責任を負いません。

ライセンス

MIT