Illustrator MCP Server

Illustrator MCP 服务

一个用于驱动 Adobe Illustrator 的 MCP 服务：可操作文档、画板、图层、形状和路径、文本、颜色、路径查找器操作和导出。它运行在安装了 Illustrator 的计算机上，并通过 Illustrator 自带的脚本接口 ExtendScript 与其通信。

需要在 macOS 或 Windows 上安装 Illustrator 2023 或更高版本，以及 Node.js 18 或更高版本。

安装

Claude Code：

claude mcp add illustrator -- npx -y adobe-mcp-illustrator

任何可读取 mcpServers 配置块的客户端（Claude Desktop、Cursor、Warp 等）：

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

在 macOS 上，首次调用时会请求控制 Illustrator 的权限（系统设置 > 隐私与安全性 > 自动化）。

约定

• 位置和尺寸的单位是点（72 pt = 1 in），以画板左上角为原点（artboardIndex 默认为 0），y 轴向下递增。Illustrator 自身的文档坐标系向上递增；服务会进行双向转换，并处理大画布文档。
• 项目通过 target 选择：{ ids: [...] }、{ names: [...] } 或 { selection: true }。Id 是 Illustrator 自身的项目 Id（PageItem.uuid）；可通过 list_items 以及每个创建图稿的工具获取。
• 颜色可以是色板名称、"#RRGGBB"、"rgb(r,g,b)"、"cmyk(c,m,y,k)"、"gray(g)" 或 "none"。创建文档时会固定其颜色模式，因此 create_document 会要求指定颜色模式。
• 字体使用 PostScript 名称；可通过 list_fonts 查找。
• 文件必须位于主文件夹或 ILLUSTRATOR_ALLOWED_DIRS 中的目录内。

工具

区域	工具
文档	get_document_info、list_documents、create_document、open_document（AI、带裁切框的 PDF 页面、EPS、SVG、带导入选项的 AutoCAD、图像、CGM、CorelDRAW、EMF/WMF、Word、RTF、文本）、save_document（.ai 或 .eps、每个画板分别保存为单独文件、旧版本的透明度）、close_document
文档命令	new_from_template、save_document_copy、revert_document、close_all_documents、list_document_presets、create_document_from_preset（名称、大小、方向、单位、颜色模式、栅格效果、预览模式、透明度网格、出血）、get_document_setup、set_document_setup（颜色模式、标尺原点、大画布、编辑画板）、open_document_with_options（旧版文件、最近使用的文件、作为库打开）、get_file_info、set_file_info（文件信息和 XMP）、use_clipboard（剪切、复制、粘贴、原位粘贴、粘贴到所有画板、不带格式粘贴）、switch_document
画板	list_artboards、add_artboard、set_artboard（方向、随画板缩放图稿）、delete_artboard、set_active_artboard、fit_artboard_to_artwork（所选图稿或图稿边界）、rearrange_artboards、copy_artboard（复制、剪切、复制到其他文档）、delete_empty_artboards、align_artboards、reorder_artboards、convert_to_artboards、set_artboard_display（中心标记、十字线、视频安全区域和标尺、标尺原点、边框、显示 / 隐藏画板）、view_artboard
图层	list_layers、create_layer、set_layer_properties（图层选项、挖空）、set_active_layer、delete_layer、move_items_to_layer（或发送到当前图层）、organize_layers（合并、拼合、收集到新图层、释放到图层、反转顺序）、set_other_layers（隐藏、锁定或以轮廓显示其他图层）、select_layer_artwork、paste_artwork（在前方或后方粘贴）
形状和路径	create_rectangle、create_ellipse、create_polygon、create_star、create_line（终点，或长度和角度）、create_path、create_arc、create_spiral、create_rectangular_grid、create_polar_grid（每项均包含对应工具的对话框选项）
实时形状	convert_live_shapes（转换为形状、扩展形状）、toggle_corner_widget
文本	create_text、set_text_style、set_text_contents、convert_text_to_outlines、list_fonts
字体排印	set_character_attributes（字符、OpenType 和 CJK 选项，可应用于文本框、字符范围或所选文本）、adjust_text（大小、字距调整和字符间距步长、清除字符间距、统一字体、适合标题）、set_paragraph_attributes（缩进、间距、断字、对齐方式、排版引擎、CJK 选项）、set_tab_stops、get_text_attributes、list_text_styles、create_text_style、edit_text_style、delete_text_styles、apply_text_style（以及清除覆盖）、load_text_styles、set_text_frame_options（点文本 / 区域文本转换、区域文字选项、光学边界、抗锯齿）、thread_text_frames
文字	create_path_text（路径文字、形状中的区域文字）、set_path_text（路径效果、起点和终点、间距、翻转、旧版更新）、change_case、insert_special_character（符号、破折号、引号、空格、强制换行）、apply_smart_punctuation、fill_placeholder_text、run_type_command（将项目符号转换为文本、显示隐藏字符、自动拼写检查）、list_document_fonts（包括缺失字体）、replace_font、find_replace_text（区分大小写、全字匹配）、set_text_wrap、list_stories、update_legacy_text、set_text_orientation、import_text、export_text、set_asian_type（排版引擎、禁则、文字组排、压缩、字距、纵中横、割注）、set_right_to_left_text（方向、中东排版引擎、数字、延长线）
外观	set_fill、set_stroke（两者均支持专色和全局色板的色调，或渐变色板）、set_opacity、get_appearance、create_gradient
图形样式和填充 / 描边控制	list_graphic_styles、apply_graphic_style（替换或合并）、rename_graphic_style、delete_graphic_styles、save_graphic_style_library、open_graphic_styles（面板或内置库）、add_appearance_attribute（另一个填充或描边）、set_transparency_group（挖空、隔离混合）、toggle_view_option（透明度网格、实时上色间隙）、get_default_fill_stroke、set_default_fill_stroke、swap_fill_stroke、reset_fill_stroke
实时上色	make_live_paint（创建或合并）、release_live_paint、expand_live_paint
颜色	list_swatches、create_swatch（印刷色、全局色、专色、根据 Lab 值创建专色）、create_swatch_group、delete_swatches、add_used_colors、edit_colors（转换为 CMYK、RGB 或灰度、反相、混合）
色板管理	edit_swatch（色板选项：名称、颜色、印刷色 / 全局色 / 专色）、duplicate_swatches、merge_swatches、find_unused_swatches、add_current_color、edit_swatch_group（颜色组）、open_swatch_library、load_swatch_library（内置库或 .ai 文件、渐变预设）、save_swatch_library（将色板库另存为 AI，或添加到现有库）
重新着色和渐变	adjust_colors（通过脚本进行：增加饱和度、调整色彩平衡、互补色、Web 安全色、可打印颜色；应用于对象或颜色组）、overprint_black、apply_gradient（渐变工具的放置方式、在多个对象上应用单个渐变、预定义渐变）
颜色管理	get_color_settings（设置文件、文档配置文件）、load_color_settings、set_color_view（校样设置、校样颜色、渐变注释器）
选择和排列	list_items、get_selection、select_items、select_same、select_all、deselect_all、delete_items、duplicate_items、move_items、scale_items、rotate_items、reflect_items、align_items（与所选对象、画板或关键对象对齐）、arrange_items、group_items、ungroup_items（取消一层分组，或使用“全部取消编组”逐层取消）
合并	make_clipping_mask、make_compound_path、pathfinder（还包括强光、柔光和陷印）
路径	path_operation（描边轮廓化、连接、添加锚点、反转方向、分割下方对象、释放复合路径、使像素完美、扩展外观）、average_points（并连接）、clean_up、split_into_grid、split_path、set_path_options（填充规则、参考线、像素对齐）、get_path_info（面积、长度、锚点）
效果	apply_effect（投影、内发光和外发光、羽化、涂抹、圆角、转换为形状、自由扭曲、收缩和膨胀、粗糙化、变换、微调、扭曲、锯齿、15 种变形、偏移路径、对象和描边轮廓化、裁切标记、栅格化、高斯模糊、NTSC 颜色）、apply_svg_filter、apply_last_effect、set_raster_effect_settings
变换	transform_each（随机、复制）、shear_items、apply_matrix、repeat_transform（再次变换）、resize_items（宽度和高度、相对或绝对值）、get_bounds（几何边界、可见边界、控制边界）、nudge_items、set_transform_options（参考点、缩放描边和效果、边界框）、reset_bounding_box、distribute_items（边缘、中心、间距、精确间隙）、distort_items（自由扭曲和透视扭曲）
封套和路径上的对象	make_envelope（使用顶部对象）、edit_envelope（释放、扩展、编辑内容）、expand_objects_on_path
选择	select_by_type（选择 > 对象：文本、点文本和区域文字、剪切蒙版、游离点、画笔描边、未对齐像素的对象、相同图层、方向手柄）、change_selection（重新选择、反选、上一个或下一个对象）、select_nested_items（组内对象，或上一级组）、select_similar_items（在容差范围内按描边粗细和不透明度选择、混合模式）、toggle_global_edit、lock_items 和 hide_items（目标对象、上方图稿或其他所有对象）、unlock_all、show_all、set_isolation_mode
剪切蒙版	release_clipping_mask、edit_clipping_mask（编辑蒙版、编辑内容）、add_to_clipping_mask（添加到剪切组，或像“内部绘图”一样沿路径创建蒙版）、remove_from_clipping_mask
图表和网格	list_graphs、apply_graph_data（加载变量库、显示数据集）、list_meshes
路径编辑	edit_anchor_points（删除、转换为角点或平滑点、设置锚点和手柄）、copy_items（复制到其他文档或剪贴板）、simplify_path（曲线精度、角度阈值、直线）、compound_shape（使用形状模式创建、释放、扩展）、repeat_pathfinder、intertwine（创建、释放）
混合	make_blend（可选择将文字轮廓化以制作混合字样）、set_blend_options（步数、方向）、release_blend、expand_blend、reverse_blend、replace_blend_spine
首选项和工具	get_preferences、set_preferences、select_tool（包括图表、网格、混合和打印拼贴工具）
置入和导出	place_image（图像、PDF 页面、EPS 和 DCS、SVG、AI、AutoCAD、CGM、CorelDRAW、EMF/WMF）、export_png（缩放或适合、消光、HTML）、export_jpeg、export_svg（另存为 SVG：配置文件、字体子集、编码、XMP、切片、文本选项）、export_web_svg（导出为 SVG：样式、ID、压缩、自适应）、export_for_screens（画板、资源和整个文档；按比例因子、宽度、高度或分辨率缩放；每种格式的高级设置）、export_pdf（预设以及 PDF/X、压缩和降采样、字体子集、出血、标记、颜色转换、输出意图、拼合、密码和权限、Acrobat 图层）
变量和数据集	list_variables、create_variable、bind_variable、delete_variables、create_data_sets（根据记录创建：文本、图像文件、可见性）、show_data_set、delete_data_sets、export_data_sets（将每个数据集导出为 PNG 或 JPEG）、import_variables、export_variables、set_variables_locked
印前和打印	set_overprint、make_trap_stroke、flatten_transparency、toggle_prepress_view（叠印预览、打印拼贴、分色预览、拼合器预览、属性）、create_trim_marks、list_print_settings、print_document（打印到打印机或 PostScript 文件；使用预设以及“打印”对话框中的各个页面，并设置文档油墨选项）
3D	apply_3d_effect（凸出、绕转、膨胀、旋转：3D 和材质效果，或带有旋转、透视和表面选项的 3D 经典效果）
画笔	list_brushes、apply_brush（并扩展为轮廓）、import_brushes（从库文件导入）、save_brush_library、open_brush_library
透视网格	set_perspective_grid（预设、显示或隐藏、活动平面、将平面与对象匹配、“视图”菜单切换项）、attach_to_perspective、release_perspective、import_perspective_presets、export_perspective_presets
图案和重复	create_pattern（对象 > 图案 > 建立）、apply_pattern（填充或描边）、rename_pattern、edit_pattern（进入或退出图案编辑模式）、transform_pattern（仅移动、缩放、旋转、反射或倾斜图案）、make_repeat（径向、网格或镜像，并提供选项）、set_repeat_options、release_repeat
图像描摹	trace_image（预设以及“图像描摹”面板中的所有选项，可选择扩展）、set_trace_options（重新描摹、另存为预设）、get_trace_info（路径、锚点、颜色）、expand_trace、release_trace、list_tracing_presets
符号	list_symbols（实例计数、未使用项）、create_symbol（注册点、替换图稿）、place_symbol、replace_symbol、select_symbol_instances、break_symbol_link、rename_symbol、duplicate_symbol、delete_symbols（或删除所有未使用项）、open_symbol_library（内置库或文件）、save_symbol_library
其他格式	export_psd（图层、可编辑文本、颜色模型、分辨率）、export_tiff（LZW、字节顺序、颜色模型、分辨率）、export_web_image（GIF 和 PNG-8，可设置颜色数、减色方式、抖动、消光、有损 GIF）、export_autocad（DWG 或 DXF：版本、比例、颜色、栅格格式）、export_selection_as_ai、place_text_file
资源导出和切片	list_assets、collect_assets（作为单个资源或每个对象分别收集）、rename_asset、remove_assets、export_selection（PNG 或 .ai）、list_slices、edit_slices（创建、释放、根据所选内容或参考线创建、复制、合并、裁切到画板、删除全部、显示 / 隐藏、锁定、切片矩形）、set_item_url（图像映射和切片 URL）
图像和链接	list_images（含状态和文件详情的链接、嵌入的图像、嵌入的文件、非原生和插件图稿）、relink_images（单个文件、所有实例、从文件夹中查找缺失的链接）、update_links（更新或嵌入）、go_to_link、place_images（在网格中放置多个文件、Photoshop 导入选项）、rasterize_items（所有“栅格化”选项）、crop_image、colorize_image、run_image_command（移除背景、创建或释放样机）
动作和自动化	list_actions（“动作”面板中的组，或 .aia 文件中的步骤）、play_action、load_actions（载入或替换动作；载入前可重命名动作、移除动作或其步骤，以及打开或关闭步骤或其对话框）、create_action_set（根据已保存的步骤创建新动作）、unload_actions（卸载动作、动作组，或清除所有动作）、run_batch（通过脚本执行批处理：处理文件夹中的文件或所有数据集，并输出到指定位置）、run_script_file、import_csv_data（将 CSV 数据源导入为数据集）、get_item_data 和 set_item_data（标签和备注）
实用工具	illustrator_status、execute_menu_command、find_menu_commands、execute_illustrator_code、help
help({ tool }) 用于说明任意工具的参数。

如何避免妨碍你

• 不会弹出对话框。 每个脚本运行时都会关闭 Illustrator 的警报，并在运行后恢复你的设置；即使脚本失败也会如此，因此警告不会导致调用一直等待。
• 你的设置会恢复。 脚本使用的坐标系仅为该脚本设置，并会在运行后恢复。
• 超时会说明原因。 如果 Illustrator 在 ILLUSTRATOR_SCRIPT_TIMEOUT_MS（默认 120 s）规定的时间内没有响应，错误会提示 Illustrator 中可能有对话框处于打开状态。
• 会检查菜单命令。 Illustrator 会忽略它不认识的菜单命令名称，也不会报告执行成功的命令。execute_menu_command 仅接受 859 个已知名称（除非你传入 allowUnknown），并会返回命令执行后的选区和文档状态，方便你查看执行结果。
• 实时效果和首选项源自已发布的实践。 Adobe 没有记录 apply_effect 和 pathfinder 传给 applyEffect 的 LiveEffect XML，也没有记录 set_preferences 使用的首选项键；该服务仅使用已发布脚本依赖的参数和键，并在功能图谱中记录其来源。pathfinder 可以回退到 Illustrator 的菜单命令，并使用 method: "menu"。Photoshop 效果（效果画廊、艺术效果、素描、纹理等）不提供：每条命令都会打开对话框，而且其 LiveEffect 参数以编码后的二进制形式存储，没有已发布的脚本会设置这些参数。不会打开对话框的 NTSC Colors 是例外。
• 通过临时 Action 执行命令。 对象模型无法设置混合的步数或方向、运行简化、创建路径查找器复合形状或拼合透明度，因此 make_blend、set_blend_options、simplify_path、compound_shape 和 flatten_transparency 会写入仅含一步的 Action，关闭其对话框后执行，再将其卸载。Action 参数采用已发布脚本和录制的 Action 集所使用的参数。
• 由脚本处理对话框功能。 平均、清理、拆分为网格、分别变换、批处理和若干编辑颜色命令会打开对话框，因此该服务会改用对象模型执行各对话框描述的操作。平滑和偏移路径没有这样的替代方式，因此不提供（apply_effect 搭配 offset_path 和 expand 可实现偏移路径）。
• 将 Action 作为文件编辑。 Illustrator 可以播放、加载和卸载 Action，但无法列出或修改已加载的 Action。list_actions 像 AiCommandPalette 一样从 Illustrator 的首选项中读取 Action 集；load_actions 和 create_action_set 则会先修改 .aia 文件，再加载文件。 run_batch 会逐个文件执行批处理对话框中的操作，因此长时间运行的批处理不会超时。
• 从记录创建数据集。 Illustrator 会按当前状态从图稿中捕获数据集，因此 create_data_sets 会先为绑定对象设置每条记录的值，然后再捕获数据集，这与已发布变量脚本的做法一致。
• 脚本中不使用原始输入。 调用者传入的每个值都会经过验证，并作为字面值写入脚本。

配置

变量	用途
ILLUSTRATOR_APP_NAME	macOS：指定某个副本，例如 Adobe Illustrator 2025。默认情况下，该服务通过其 bundle id 定位 Illustrator。
ILLUSTRATOR_ALLOWED_DIRS	用于打开、置入和导出文件的额外目录（macOS 使用 : 分隔，Windows 使用 ; 分隔）。
ILLUSTRATOR_SCRIPT_TIMEOUT_MS	等待 Illustrator 响应的时长。默认值为 120000。
ILLUSTRATOR_BACKEND / ILLUSTRATOR_TARGET	设置为 artcraft 或 vectorcraft，通过环回 JSON-lines 将工具调用路由到 VectorCraft。默认值为 auto（如果 Adobe Illustrator 未运行，且 VectorCraft 正在端口 7979 上监听，则路由到 VectorCraft）。
VECTORCRAFT_CONTROL_PORT	VectorCraft 控制通道的端口。默认值为 7979。
VECTORCRAFT_CONTROL_TOKEN	如有需要，用于 VectorCraft 身份验证的令牌。

开发

npm test         # definitions, argument parsing, protocol, and the static script audit
npm run audit    # the audit alone, with findings listed
npm run check    # syntax check

静态审计会使用示例参数运行每个工具，并对 Illustrator 进行桩替代，检查生成的每个脚本是否符合 ES5 语法，以及是否只使用 Illustrator 脚本对象模型（2022 至 2025）中的名称。它不会在 Illustrator 中运行任何内容：通过审计的工具不一定已在应用程序中运行过。

共享基础设施（脚本转义、执行器、服务外壳、审计）来自 adobe-mcp-core，这是与 adobe-mcp-indesign 共用的基础。

许可证

MIT。菜单命令数据请参阅 LICENSE 和 NOTICE。