illustrator-mcp-server

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

🇯🇵 日语版 README 请参阅 README.ja.md。

Illustrator MCP 服务

一个用于读取、操作和导出 Adobe Illustrator 设计数据的 MCP（Model Context Protocol） 服务，内置 66 个工具。

可通过 Claude 等 AI 助手直接控制 Illustrator，提取设计信息以用于 Web 实现、核验可直接印刷的数据并导出素材。

Adobe 官方 Illustrator MCP（测试版）能做的所有事，这里都能做到，甚至更多。请参阅对比。

说明

在 Claude 的扩展目录和插件市场中，本项目列为 Design Bridge by IE3。Anthropic 的目录不允许在列表名称中使用其他公司的品牌名称，因此列表名称有所不同——但这是同一个项目，npm 软件包仍为 illustrator-mcp-server。如果你在 Claude Code 中安装的插件使用的是早期名称（illustrator@ie3jp-illustrator），请参阅 Claude Code 重新安装。

🎨 作品展示

以下所有作品均由 Claude 通过自然语言对话全程创作，未进行任何手动 Illustrator 操作。

活动海报	Logo 概念
名片	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 → 设置 → 扩展
3. 将 .mcpb 文件拖放到扩展面板中
4. 点击 安装 按钮

{
  "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）的版本不受支持。如果未经验证的版本出现问题，请提交问题。

说明

如果 Illustrator 已在运行，服务会连接到当前运行的实例，而不受版本设置影响。只有在 Illustrator 尚未运行时，才会使用此版本设置来启动正确的版本。

环境变量

当单次调用所需时间超过默认值时，请调高这些值：例如，使用 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 在 Illustrator Beta（30.4+，截至 2026 年 8 月仍仅限 Beta 版）中内置了 MCP 服务，专注于分析和批量处理现有文档。这个项目涵盖了相同的工作流——分析、批量重新着色、变体、批量画板导出、字体／断开链接检查——并新增了官方服务不具备的功能：从头创建作品、保存文档、印刷与印前检查，以及设计系统工具。而且它可在稳定版 Illustrator 上运行，无需 Beta 版。

* 根据截至 2026 年 4 月的用户报告（Beta 版）。官方服务仍在积极开发中 — 请参阅 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 文档使用类似 Web 的坐标系，更便于 AI 操作
• 如有需要，可使用 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