A background-mode MCP server that reads, edits, exports, and preflights Adobe Illustrator documents via ~81 tools, including batch card production and a trusted ExtendScript escape hatch.
Runtime & safety: check background policy and execution ownership (get_runtime_status), recover unproven timeouts (recover_execution), set workflow/coordinate defaults and target Illustrator version.
Scripting: run trusted ExtendScript in a shared background executor (run_script) with syntax checks and JSON param passing.
Inspect documents: document info, artboards, layers, groups, selection, text frames (with pagination, reading-order sort, per-character runs), paths, colors, effects, images, symbols, guidelines, and full structure trees; search objects by name/type/font/color.
Create & edit: rectangles, ellipses, lines, text frames, path text, custom paths, place images/SVG/PDFs/symbols, create/clone/move/group/ungroup/duplicate/delete/align/z-order objects, modify properties, outlines, gradients, swatches, graphic and text styles, layers, artboards, variables/datasets, undo/redo.
Documents: create, open, save/save-as, close, assign color profile, relink/embed linked images.
Export & print prep: SVG/PNG/JPG/PDF export (including all artboards), preflight checks, contrast, overprint/separation info, text consistency, design tokens, crop marks, color chips, style guides.
Batch card production: duplicate layer trees, replace masked images, import outlined PDF name paths, build gradient name backing, run detached batch_cards jobs with status polling, and independently validate outputs with previews.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Illustrator MCP Unified inspect the layers in my open Illustrator document in the background"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
这是一个根据 ie3jp/illustrator-mcp-server 和 ajfonthemove/illustrator-mcp 制作的 MCP，当前工具数量 81。
经过我自己的测试，在本机 macOS（Apple Silicon）+ Adobe Illustrator 2026（30.2.1） 上运行良好，可以在后台静默完成任务，不需要保持 Illustrator 在前台。
PS：如果你无法使用，可以自己用你的 AI 修复看看。
本项目以 ie3jp/illustrator-mcp-server 的 67 个工具为基础，参考 ajfonthemove/illustrator-mcp 的通用脚本入口思路，增加后台执行、任务恢复和批量制卡能力。通用脚本入口重新实现，并统一到同一个执行器中。
读取和编辑 Illustrator 文档、图层、路径、文字、图片，保存和导出作品。
默认后台执行，不主动把 Illustrator 切到前台，不通过模拟鼠标键盘完成任务。
通过 run_script 运行可信的 ExtendScript，补充专用工具没有覆盖的操作。
按模板批量制卡：复制完整图层、替换蒙版内图片、导入可编辑 PDF 字稿、生成名称渐变衬边。
保存后重新打开文件检查结构，导出预览供 AI 和用户检查。
多个调用共用任务占用记录，避免同时修改文档；超时后保留记录，不盲目重跑。
预检、批量组装 SVG 为可编辑路径，并在运行状态中查看占用与恢复信息。
工具清单见 docs/TOOLS.md。
Related MCP server: indesign-mcp-server
需要 Node.js 22.12 或更高版本、macOS，以及已经安装的 Adobe Illustrator。当前公开版本以 macOS 为验证范围；没有验证 Windows 的后台行为。
在终端执行：
git clone https://github.com/lazyq666/illustrator-mcp-unified.git
cd illustrator-mcp-unified
npm ci
npm run build
npm run verify
npm run configurebuild 把源码生成可运行程序；verify 检查 MCP 连接、81 个工具和后台配置，不修改 Illustrator 文档。configure 根据这台电脑的实际路径生成连接配置，也不会修改你的个人设置。
如果安装了多个 Illustrator 版本，可明确选择：
npm run configure -- --app "/Applications/Adobe Illustrator 2026/Adobe Illustrator.app"生成的 generated/codex-config.toml 是需要合并到 Codex 配置中的 MCP 条目。保留其他设置；已有同名条目时先备份再替换，避免重复添加。
也可以把 generated/安装到Codex的提示词.txt 发给 Codex，让它按实际路径完成配置和配套 skill 安装。
配置后重新连接 MCP。开始操作前，先手动打开 Illustrator；首次连接时，macOS 可能要求允许客户端自动化控制 Illustrator。
使用生成的 generated/mcp-config.json，将其中的 mcpServers 条目合并到支持本地 stdio MCP 的客户端配置中。stdio 是由客户端直接启动本机程序的连接方式，不需要部署服务器或填写 API Key。
配置结构如下，实际使用时优先复制生成的文件：
{
"mcpServers": {
"illustrator-mcp-server": {
"command": "/absolute/path/to/node",
"args": ["/absolute/path/to/illustrator-mcp-unified/dist/index.js"],
"env": {
"ILLUSTRATOR_MCP_BACKGROUND": "1",
"ILLUSTRATOR_MCP_STATE_DIR": "/absolute/path/to/illustrator-mcp-unified/var",
"ILLUSTRATOR_MCP_APP_PATH": "/Applications/Adobe Illustrator 2026/Adobe Illustrator.app",
"ILLUSTRATOR_MCP_KEEP_AWAKE": "1"
}
}
}
}为兼容配套 skill，连接条目保留 illustrator-mcp-server 这个名称。原来的同名 MCP 和 illustrator-bridge 应停用，避免 AI 混用多个 Illustrator 入口。
移动项目文件夹后，重新运行 npm run configure 并更新客户端配置。该版本通过 GitHub 源码分发，尚未发布到 npm。
连接后可以这样告诉 AI：
先检查统一 Illustrator MCP 的运行状态，确认后台模式正常，再读取当前文档的图层结构。不要切换 Illustrator 到前台。
get_runtime_status 的预期值：
字段 | 预期 |
|
|
|
|
|
|
|
|
| 配置中指定的 |
| 空闲时均为 |
可选制卡 skill 位于 skill-template/illustrator-batch-cards。请安装 configure 生成的 generated/illustrator-batch-cards，它已填入本机状态目录，原始模板中的占位符不能直接使用。
该 skill 要求每次文档操作前检查版本和后台状态。检查不符就停止并提示，不自动切换其他 MCP、Computer Use 或终端脚本。批量任务返回 ready_for_visual_review 只表示结构检查通过，仍需查看导出的预览。
Illustrator 必须已经打开，macOS 用户会话保持登录。屏幕可以锁定，但电脑不能进入系统休眠。
执行时默认临时阻止空闲休眠，允许熄屏和锁屏；合盖、手动休眠、退出登录和退出 Illustrator 会影响任务。
依赖弹窗、菜单或剪贴板的操作可能被后台策略拒绝，不会自动转为电脑操作。
run_script 面向可信脚本，包含后台策略和语法检查，但不是隔离恶意代码的安全沙箱。
批量制卡需要先检查并整理实际模板。字体、链接素材、特殊效果和不同 Illustrator 版本都可能影响结果。
任务超时不等于 Illustrator 已经停止。先读状态和日志；recover_execution 仅在有完成证据时释放占用记录，不会取消或重跑任务。
npm run check当前源码包含自动测试，另有 MCP 连接和工具数量检查。开发过程中在上述本机环境验证过后台保存、重开、导出、两张卡的批量生成，以及锁屏期间继续执行。这些测试不代表 81 个工具、所有模板和所有 Illustrator 版本均已完整验证。
2026-10-30 更新：批量制卡默认每 4 张保存、关闭并重开同一输出文件，最终保存默认保留 PDF 兼容性；长任务的 AppleScript 等待时间随执行超时延长。新增分组流程已覆盖自动测试，尚未在真实 Illustrator 中验证。
请勿提交 generated/、var/、个人客户端配置或作品素材；这些本机文件已经加入 .gitignore。
ie3jp/illustrator-mcp-server：主要代码基础，保留其 MIT 版权声明。
ajfonthemove/illustrator-mcp：通用脚本桥接思路参考；未打包该项目的源码或素材。
本仓库使用 MIT License。更多版本来源见 NOTICE.md。这是个人使用与分享的社区项目，与 Adobe 没有官方隶属关系。
Align and/or distribute multiple objects by their UUIDs
Inputs: uuids (required), alignment, reference, distribute, +1 more.
Apply a graphic style to objects. Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: uuids (required), style_name (required), merge.
Apply a character or paragraph style to a text frame. Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: uuid (required), style_name (required), style_type (required), clear_overrides.
Assign (tag) a color profile to the document. WARNING: This only changes the profile tag — it does NOT convert color values (ICC conversion). For full conversion, use Edit > Convert to Profile in Illustrator. Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: profile (required).
Start a detached background card job from a saved normalized AI template and confirmed content. Creates a new output, copies linked images into Links, clones complete layers, replaces named text/images, imports optional PDF name paths and builds backing. Saves each card, removes template copies, reopens for structural checks and exports previews. No image downscaling or UI fallback. Return is job acceptance, not completion; poll get_batch_status and visually inspect previews. One simple card template per source document; verify the template first.
Inputs: cards (required), output_path (required), template_path (required), gap_pt, +3 more.
Duplicate an editable name face behind itself, apply a template gradient or explicit RGB stops, and attach a live Offset Path effect. Preserves face holes and separate face/backing objects. Bounds and thickness are native document points; visual review is still required.
Inputs: style (required), face_name (required), document_path (required), root_layer_path (required).
Check WCAG color contrast ratios. Manual mode: provide two colors. Auto mode: detect overlapping foreground/background pairs in the document. Note: GrayColor uses ink-quantity interpretation (0=white, 100=black), which differs from the API reference.
Inputs: color1, color2, auto_detect.
Analyze text frames for dummy/placeholder text and known notation variation patterns (katakana long vowel, fullwidth/halfwidth, wave dash/tilde). Returns all text contents for LLM-driven deeper analysis of inconsistencies, typos, and version mismatches. Note: AI analysis may miss errors and does not replace a human text review.
Inputs: artboard_index, coordinate_system.
Close the active Illustrator document. Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: save.
Convert a point between artboard and document coordinate systems in the active document.
Inputs: to (required), from (required), point (required).
Convert text to outlines. Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: target (required).
Create crop marks (トンボ / trim marks) on the active artboard or selected objects. By default, creates marks for the artboard and expands the artboard to include all marks. With use_selection=true, creates marks for the currently selected object(s) without modifying the artboard. Automatically selects Japanese-style (日本式) or Western-style crop marks based on locale. Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: style, locale, use_selection, artboard_index.
Create a new Illustrator document. Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: width, height, color_mode.
Create an ellipse. Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: x (required), y (required), width (required), height (required), +5 more.
Create a gradient in the document and optionally apply it to objects. Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: name (required), stops (required), type, angle, +1 more.
Create a line. Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: x1 (required), x2 (required), y1 (required), y2 (required), +4 more.
Create a custom path. Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: anchors (required), fill, name, closed, +3 more.
Create a text frame that flows along a path. Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: contents (required), path_uuid (required), name, font_name, +2 more.
Create a rectangle. Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: x (required), y (required), width (required), height (required), +6 more.
Create a text frame. Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: x (required), y (required), contents (required), fill, +8 more.
Delete one or more objects by UUID (get UUIDs from find_objects / get_layers / get_selection). Locked objects are skipped unless force_unlock is true. Reversible with the undo tool. To delete a whole layer use manage_layers instead. Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: uuids (required), force_unlock.
Copy a complete layer hierarchy into a new parent layer in the specified open document, preserving item order, clipping groups and child layer state. Native document coordinates in points. Refuses a duplicate target parent.
Inputs: document_path (required), source_layer_paths (required), target_parent_name (required), offset_x, +1 more.
Duplicate one or more objects, optionally offsetting the copies. Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: uuids (required), offset, target_layer, coordinate_system.
Export objects, groups, artboards, or selection. Use target "artboard:all" to batch-export every artboard in one call. For single PNG/JPG exports, the exported image is returned as base64 in the response — you can view it directly without reading the file from disk ("artboard:all" returns file paths only). Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: format (required), target (required), scale, output_path, +2 more.
Export print-ready PDF. Runs without activating Illustrator in default background mode; never invokes Computer Use. The exported PDF should be verified by a human before final submission.
Inputs: preset, options, output_path.
Extract colors, typography, and spacing from the document as design tokens in CSS custom properties, JSON, or Tailwind format
Inputs: format, output_path.
Search for objects by specified criteria
Inputs: name, type, font_name, font_size, +5 more.
Get all artboard information
Inputs: index, coordinate_system.
Read a background card job and its per-card progress, prepared plan, log and preview paths. ready_for_visual_review means structural checks passed, not visual approval. Never automatically restart failed or unconfirmed jobs.
Inputs: job_id (required).
Get all color information used in the document
Inputs: include_swatches, include_diagnostics, include_used_colors.
Get document metadata
Inputs: coordinate_system.
Get tree structure of layers, groups, and objects
Inputs: depth, artboard_index, coordinate_system.
Get effect and appearance information
Inputs: target, selection_only, coordinate_system.
Get structure of groups, clipping masks, and compound paths
Inputs: depth, layer_name, coordinate_system.
Get guide information
Inputs: coordinate_system.
Get embedded and linked image information
Inputs: coordinate_system, include_print_info.
Get layer structure as a tree
Inputs: include_items, coordinate_system, include_sublayers.
Get overprint settings with K100/rich black detection and intent classification
Inputs: no named parameters.
Get path and shape data. Note: fill/stroke do not include per-attribute opacity; use the item-level opacity field for transparency.
Inputs: layer_name, include_points, selection_only, coordinate_system.
Read background policy and cross-process execution ownership without sending a script to Illustrator. An uncertain execution must not be replayed. No Computer Use.
Inputs: no named parameters.
Get detailed information about the currently selected objects
Inputs: coordinate_system.
Get color separation information: CMYK process plates and spot color plates with usage counts
Inputs: no named parameters.
Get symbol definitions and instances
Inputs: coordinate_system.
Get detailed text frame attributes including per-character runs (font, tracking, akiLeft/akiRight, tsume, proportionalMetrics), kerning pairs with manual kerning values (1/1000 em), and paragraph attributes. Returns cssHints for web/CSS reproduction. Note: paragraph leading/autoLeading may return 0 in some ExtendScript versions due to missing API support.
Inputs: uuid (required), coordinate_system.
Group multiple objects into a single group. The first UUID in the array becomes the bottommost item, the last becomes the topmost. Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: uuids (required), name, clipped.
Open a prepared outlined vector PDF and copy actual paths into an open target document, retaining compound paths and holes. No clipboard, linked PDF or raster substitute. Rejects source PDFs already open by the user. Bounds use native document points.
Inputs: pdf_path (required), group_name (required), document_path (required), target_layer_path (required), +2 more.
Import an SVG file into the active document as editable Illustrator paths/text/groups (NOT as a linked image). Internally opens the SVG as a temporary document, duplicates its contents into the target document, then closes the source. Use this instead of place_image for SVG. Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: file_path (required), x, y, name, +5 more.
List fonts available in Illustrator. Does not require an open document.
Inputs: limit, filter.
List all graphic styles in the active document.
Inputs: no named parameters.
List text frames with summary-level information. Supports reading-order sort, pagination, and a lightweight contents-only mode.
Inputs: sort, limit, offset, layer_name, +3 more.
List all character and paragraph styles in the active document.
Inputs: no named parameters.
Add, remove, resize, rename, fit, or rearrange artboards. Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: action (required), name, rect, index, +3 more.
List variables/datasets, apply or create datasets, bind variables to objects, import CSV/XML. CSV headers are auto-bound to objects with matching names. Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: action (required), file_path, object_name, dataset_name, +2 more.
Add, rename, show/hide, lock/unlock, reorder, or delete layers
Inputs: action (required), above, new_name, position, +1 more.
Relink or embed a placed (linked) image. embed converts PlacedItem to RasterItem — the original UUID becomes invalid and a new UUID for the RasterItem is returned. Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: uuid (required), action (required), new_path.
Add, update, or delete swatches in the active document. Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: name (required), action (required), color.
Modify properties of an existing object. Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: uuid (required), properties (required), coordinate_system.
Move one or more objects to a different layer. Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: uuids (required), target_layer (required), position.
Open an Illustrator document from a file path. Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: path (required), color_space.
Extract all unique colors from the document and place color chip swatches with labels outside the artboard
Inputs: position, chip_size, layer_name, include_info, +2 more.
Place a raster or PDF image file (PNG, JPG, TIFF, PSD, PDF, etc.) into the document as a linked or embedded image. SVG is NOT supported here because PlacedItems produces a non-editable linked artwork — use import_svg_as_editable instead to bring SVG content in as editable paths/text. Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: file_path (required), x, y, name, +3 more.
Place a visual style guide (color chips, font samples, spacing indicators) outside the artboard
Inputs: position, layer_name, artboard_index, coordinate_system.
Place a new symbol instance or replace the symbol definition of an existing instance. Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: action (required), symbol_name (required), x, y, +2 more.
Run pre-press quality checks. Note: This check is not exhaustive — it does not replace a human final review. GrayColor uses ink-quantity interpretation (0=white/no ink, 100=black/full ink), which differs from the API reference.
Inputs: min_dpi, coordinate_system, target_pdf_profile.
Recover an uncertain execution only after a valid native completion receipt or a recognized legacy native compile failure. Requires the exact execution_id from get_runtime_status. Archives the evidence, releases only that lock, and never sends a script, cancels, or retries Illustrator work. Refuses running or unproven timeout states.
Inputs: execution_id (required).
Find and replace colors across the document or within a specific layer. Limitations: SpotColor and GrayColor matching not supported. Cross-colorspace matching (e.g. RGB→CMYK) not possible — from_color and to_color must use the same color type as the target objects.
Inputs: to_color (required), from_color (required), scope, target, +1 more.
Replace a named raster inside its existing clipping group while preserving the image rectangle and stacking. Explicitly choose linked or embedded. Rejects rotated/sheared/mirrored images and aspect mismatches before replacement; use a template-specific script for them.
Inputs: embed (required), file_path (required), item_name (required), document_path (required), +2 more.
Create size variations from a source artboard. Duplicates all objects and scales/repositions them proportionally to fit target sizes. Limitations: no text reflow, effects/strokes scale with objects but may need manual adjustment, proportional placement only (not smart layout).
Inputs: target_sizes (required), source_artboard_index (required), scale_mode, coordinate_system.
Run trusted ExtendScript directly in the shared background executor. Supply script or an existing UTF-8 .jsx script_path, not both. Use ES3-compatible syntax (no E4X or preprocessor directives); quote reserved property names. Syntax is checked before native execution. Return plain data with return; params contains JSON input. JSON compatibility is provided. UI, clipboard and dynamic script requests are rejected in background mode. This is not a security sandbox. Use batch_cards for long jobs; never replay an unconfirmed timeout.
Inputs: params, script, script_path, document_path, +1 more.
Save the active Illustrator document. Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: mode, path.
Select objects by UUID. Pass an empty array to deselect all. Selected objects can then be manipulated interactively in Illustrator.
Inputs: uuids (required).
Set which Illustrator version to target when multiple versions are installed. Specify a version year (e.g. "2024", "2025"). If Illustrator is already running, connects to the running instance regardless of version. If not running, launches the specified version. Use clear: true to reset to default behavior (connect to any running Illustrator).
Inputs: clear, version.
Set the session-level workflow and default coordinate system. Call this after confirming the user's intent (web, print, or video). Once set, all tools that omit coordinate_system will use the session default. Use clear: true to reset to auto-detection from document (CMYK/print → document coords, RGB/web → artboard-web).
Inputs: clear, workflow, coordinate_system.
Change the stacking order of an object. Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: uuid (required), command (required).
Undo or redo actions in Illustrator. Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: count, action.
Ungroup a group, releasing its children to the parent layer. Runs without activating Illustrator in default background mode; never invokes Computer Use.
Inputs: uuid (required).
Independently reopen a saved, closed AI output, check card/layer/text/image/path correspondence, and optionally export artboard previews without the clipboard. This tool does not perform visual judgment. Use the prepared plan from get_batch_status so packaged link paths match.
Inputs: cards (required), output_path (required), preview_directory, expected_sublayers.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 77 tools
Several tools overlap in purpose, particularly the document/layer/group inspection tools (get_document_structure, get_layers, get_groups) and color analysis tools (get_colors, extract_design_tokens). The detailed descriptions help, but with 77 tools an agent may still struggle to choose the right one for a given task.
All tool names use consistent snake_case with a clear verb_noun or verb-noun-phrase pattern (e.g., create_rectangle, get_document_info, manage_layers). There are minor noun-only names like export and undo, but the overall convention is predictable and readable.
77 tools is far beyond the typical 3-15 range and exceeds the 25+ threshold for being too many. While Illustrator is a complex domain, many tools are granular and could be consolidated, and the sheer number increases the risk of misselection.
The surface covers a broad range: document lifecycle, drawing primitives, text, color, layers, export, prepress, and batch workflows. Some operations (e.g., pathfinder boolean ops, explicit rotate/scale transforms) are missing, but agents can work around minor gaps.
Split images into editable layers (PSD/PNG), outpaint images, and generate clean vector SVGs.
Preflight and convert 450+ file types for AI via TweekIT MCP & SDK (Cloud CGN or On-Prem Miner).
Convert, create and edit Word, PowerPoint, Excel and PDF documents from any AI agent.
Composable APIs for document extraction, image transformation, and document & sheet generation.
