After Effects MCP Server

After Effects MCP 服务

一个可操控 Adobe After Effects 的 MCP 服务：管理项目和素材、合成、图层、关键帧和表达式、效果、文本、遮罩以及渲染队列。它在安装了 After Effects 的机器上运行，并通过 After Effects 自带的脚本接口 ExtendScript 与其通信。

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

安装

Claude Code：

claude mcp add aftereffects -- npx -y adobe-mcp-aftereffects

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

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

在 macOS 上，首次调用时会请求授权以控制 After Effects（系统设置 > 隐私与安全性 > 自动化）。在 After Effects 中，开启“设置”>“脚本和表达式”>“允许脚本写入文件并访问网络”；文件操作需要此权限。

约定

• 合成通过 comp 指定：{ id }（项目项 ID 来自 list_items）、{ name }，或省略以使用当前活动合成。
• 图层通过 layers 指定：{ indexes: [...] }（1 = 顶部，与时间轴中的顺序一致）、{ names: [...] } 或 { selected: true }。
• 属性可以使用快捷名称（position、scale、rotation、opacity、anchor_point、source_text，……），也可以使用匹配名称或名称组成的路径，例如 ["ADBE Effect Parade", "Gaussian Blur", "Blurriness"]。
• 位置以像素为单位，从合成左上角开始计算；时间以秒为单位；颜色格式为 "#RRGGBB" 或 "rgb(r,g,b)"。
• 文件必须位于你的主目录或 AFTEREFFECTS_ALLOWED_DIRS 中指定的目录内。

工具

区域	工具
项目	get_project_info、list_items、import_files（素材、序列、作为合成的分层文件、项目）、create_folder、manage_items（重命名、移动、设置标签、删除）、save_project、open_project（或新建项目）、tidy_project（移除未使用的项目、整合、精简）
合成	create_comp、set_comp_settings（尺寸、时长、帧速率、分辨率、起始时间码、背景、运动模糊、嵌套、工作区域、时间轴开关）、create_comp_from_items（从所选项新建合成）、duplicate_comp、precompose、open_comp、run_comp_command（修剪、裁切、海报时间、提升并提取工作区域、流程图、显示）、add_comp_marker、edit_markers（合成和图层标记、提示点、标签）、save_frame（PNG）
图层	list_layers、add_layer（纯色、空对象、调整、文本、形状、摄像机、灯光或项目项）、set_layer_properties（开关、注释、质量和采样、混合模式、自动定向、标签、时间、拉伸）、set_transform、parent_layers（或跳转父级）、set_track_matte、arrange_layers、duplicate_layers（或复制到其他合成）、delete_layers、select_layers、switch_all_layers、open_layer、trim_layers、move_layers（对齐、微移、快速偏移、滑移）、split_layers、reframe_layers（适合、居中、翻转）、replace_layer_source、set_solid_settings、set_layer_styles、choose_layer_tool
时间	remap_layer_time（时间重映射、定格帧）、stretch_layers（时间拉伸、保留关键帧、匹配帧速率）、set_frame_blending、align_video_to_data
项目	get_project_info、list_items、import_files（素材、序列、作为合成的分层文件、项目、数据文件）、create_folder、manage_items（重命名、移动、设置标签、删除）、save_project、save_project_copy（.aep 或 XML .aepx）、open_project（项目、模板或新项目）、run_project_command（关闭、还原、打开最近项目、递增并保存）、tidy_project（移除未使用的项目、整合、精简）、set_project_settings（时间显示、帧计数、色深、表达式引擎、缩略图）、find_project_items、select_project_items、set_item_comment、find_missing_dependencies（素材、效果、字体）、resolve_project_fonts、edit_project_metadata（XMP）
素材	get_footage_info、interpret_footage（Alpha、帧速率、场、下拉、像素长宽比、循环、复制解释设置）、replace_footage（文件、序列、占位符、纯色、分层合成）、set_proxy、create_proxy、create_footage_item（占位符或纯色）、reload_footage、open_footage（素材面板、Finder 或 Explorer、Bridge、编辑原始文件）、detect_scene_edits、paste_svg_as_shapes
合成	create_comp、set_comp_settings（尺寸、时长、帧速率、背景、运动模糊、工作区域）、duplicate_comp、precompose、open_comp、add_comp_marker、save_frame（PNG）
图层	list_layers、add_layer（纯色、空对象、调整、文本、形状、摄像机、灯光或项目项）、set_layer_properties（开关、质量、混合模式、标签、时间、拉伸）、set_transform、parent_layers、set_track_matte、arrange_layers、duplicate_layers（或复制到其他合成）、delete_layers
动画	get_property、set_property、set_keyframes（插值和缓动）、remove_keyframes、set_expression、convert_expression_to_keyframes、set_expression_engine（JavaScript 或 Legacy ExtendScript）
关键帧	edit_keyframes（轻松缓入缓出、自动和连续贝塞尔、定格、缓动速度和影响、运动路径切线、漫游、标签、值、时间反转）、select_keyframes、go_to_keyframe、copy_animation（关键帧、反转、仅表达式或属性链接）、separate_dimensions、sequence_layers、run_animation_command（关键帧选择、关键帧助理和显示命令）、manage_puppet（木偶效果、图钉工具、网格）
效果	list_effects、apply_effect（设置属性值）、list_layer_effects、remove_effects（或关闭效果）、apply_preset（.ffx）
文本	add_text_layer（点文本或段落文本、水平或垂直）、set_text（源文本以及字符和段落格式，可应用于图层或一段字符或段落）、get_text、find_fonts、set_font_options（收藏字体、重新扫描字体文件夹）、set_text_options（路径选项、更多选项、逐字符 3D）、set_text_animator（动画器属性、可变字体轴、范围、摆动和表达式选择器）、list_text_animators、remove_text_animators、convert_text_layers（从文本创建形状或蒙版、转换为可编辑文本）、show_text_panels
效果控件	find_effects（按类别浏览效果目录，列出每个效果的控件以及是否已安装）、set_effect_controls（应用任意效果并按名称设置控件，或编辑已应用的效果；使用 time 设置关键帧）、get_effect_controls（类型、值、菜单选项、范围）、organize_effects（复制、重新排序、复制到其他图层）
文本	set_text（源文本以及字符和段落格式）
蒙版	add_mask（矩形、椭圆或路径，可设置模式、羽化、不透明度、扩展）、list_masks、set_masks（模式、锁定、锁定其他蒙版、颜色、RotoBezier、运动模糊、羽化衰减）、manage_masks（删除、全部移除、复制、选择下一个或上一个、隐藏已锁定蒙版、效果上的蒙版引用）、set_bezier_path（蒙版或形状路径顶点、第一个顶点、方向、自由变换、可变宽度羽化点）
形状	list_shape_content、add_shape_content（组、矩形、椭圆、多边形星形、路径、填充、描边、渐变，以及合并路径、偏移路径、收缩和膨胀、重复器、圆角、修剪路径、扭曲、摆动路径、摆动变换、之字形及其设置）、set_shape_content（变换、混合模式、线端和连接、虚线、锥度、波形、填充规则、合成、渐变点、运算符设置）、arrange_shape_content（删除、复制、移动、编组、取消编组、转换为贝塞尔路径）、create_shapes_from_vector_layer
绘画和抠像	select_drawing_tool（形状、钢笔、蒙版羽化、画笔、仿制图章、橡皮擦、Roto Brush 和优化边缘工具；绘画、画笔和内容识别填充面板）、list_paint_strokes、set_paint_strokes（笔触和仿制设置，可设关键帧）、set_roto_brush（Roto Brush 和优化边缘设置）
3D	set_camera_options（缩放、光圈、景深、光圈叶片、高光、兴趣点）、set_light_options（类型、颜色、强度、锥角、衰减、阴影、环境光源）、set_material_options（阴影、灯光、反射、透明度；环境图层）、set_geometry_options（斜面、挤出、曲率）、set_comp_3d_settings（3D 渲染器、草图 3D）、set_3d_view（视图 > 切换 3D 视图、重置、查看对象、从 3D 视图创建摄像机）、run_camera_command（焦点链接、环绕空对象、立体摄像机架、从 3D 模型创建摄像机和灯光）、set_camera_tool
渲染	list_render_templates、queue_render（一段范围、单帧或预渲染）、get_render_item、set_render_settings（模板和所有渲染设置选项、日志、通知）、set_output_module（模板或格式、文件和文件名模板、通道、位深、调整大小、裁切、音频、渲染后操作；添加或移除模块）、render_queue（在 After Effects 或 Adobe Media Encoder 中）、manage_render_queue（移除、复制、开启和关闭）、control_render_queue（暂停、继续、停止、面板、进度）、configure_render_engine（多帧渲染、监视文件夹）
基本图形	set_essential_graphics（主合成、模板和控件名称）、add_essential_graphics_controls（属性、下拉菜单、媒体替换）、add_protected_region（响应式设计 - 时间）、export_motion_graphics_template（.mogrt）
渲染	list_render_templates、queue_render、render_queue（在 After Effects 或 Adobe Media Encoder 中）、manage_render_queue
跟踪	start_tracking（跟踪运动、跟踪蒙版、跟踪此属性、Mocha、跟踪器面板、运动跟踪工作区）、apply_warp_stabilizer、apply_camera_tracker（3D 摄像机跟踪器）、get_tracking_data（跟踪点、人脸测量数据）、set_track_point
颜色	get_color_management（以及颜色配置文件）、set_color_management（位深、工作空间、伽马、线性化、混合）、set_display_color（显示颜色管理、模拟输出、Lumetri 示波器）、apply_color_effect（在调整图层上进行调色、广播安全处理、输出模拟）
应用程序	purge_caches（编辑 > 清除）、run_edit_command（撤销、重做、剪切、复制、粘贴、选择）、get_aftereffects_info（版本、系统、GPU、偏好设置值）、set_application_settings（内存、GPU 加速、已记录的偏好设置）、manage_script_settings、quit_aftereffects
界面	get_viewer_state、set_view_options（缩放、分辨率、通道、曝光、快速预览、标尺、参考线）、run_view_command（网格、布局、新建或关闭查看器）、edit_comp_guides、set_current_tool、go_to_time、show_panel、switch_workspace
音频	set_audio_levels、remap_layer_speed（速度和音高）、run_audio_command（将音频转换为关键帧、在 Adobe Audition 中编辑）
自动化	run_aftereffects_script_file（立即运行、定时运行或从文件 > 脚本运行）、manage_motion_graphics_template
协作	manage_team_project（状态、创建、打开、共享、获取最新版本、解决冲突、转换、关闭）
实用工具	aftereffects_status、run_menu_command、execute_aftereffects_code、help
help({ tool }) 会说明任意工具的参数。

如何避免打扰你

• 无对话框。 每个脚本运行时都会禁用 After Effects 的对话框。
• 每次调用对应一个撤销步骤。 每次调用对项目进行更改，都会在“编辑”>“撤销”中留下一个条目。
• Windows 上无需 COM。 After Effects 没有 COM 接口，因此在 Windows 上，服务会将脚本交给 AfterFX.exe -r 执行，并从文件中读取结果。如果 After Effects 不在默认位置，请设置 AFTEREFFECTS_EXE。
• 超时会说明原因。 如果 After Effects 在 AFTEREFFECTS_SCRIPT_TIMEOUT_MS（默认值为 120 s）指定的时间内没有响应，错误会提示可能有对话框处于打开状态。长时间渲染时可调高此值。
• 脚本中不包含原始输入。 调用方传入的每个值都会经过验证，并以字面量形式写入脚本。

配置

变量	用途
AFTEREFFECTS_APP_NAME	macOS：指定要连接的 After Effects 副本，例如 Adobe After Effects 2025。默认情况下，服务通过其 bundle id 定位 After Effects。
AFTEREFFECTS_EXE	Windows：AfterFX.exe 的路径。
AFTEREFFECTS_ALLOWED_DIRS	导入、保存和渲染时允许使用的额外目录（macOS 上以 : 分隔，Windows 上以 ; 分隔）。
AFTEREFFECTS_SCRIPT_TIMEOUT_MS	等待 After Effects 的时长。默认值为 120000。
AFTEREFFECTS_TARGET	设置为 craft，将命令路由到 EffectCraft。
EFFECTCRAFT_CONTROL_PORT	EffectCraft 桥接端口（默认值为 9877）。

ArtCraft（EffectCraft）支持

此服务支持透明适配器，可用于 Storytold 的 EffectCraft 动态图形应用。当 After Effects 未安装或未运行，或者设置了 AFTEREFFECTS_TARGET=craft（或 ADOBE_TARGET=craft）时，兼容的工具会直接路由到 EffectCraft 的 loopback 桥接协议（默认地址为 127.0.0.1:9877，也可通过 EFFECTCRAFT_CONTROL_PORT 指定）。

开发

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

src/data/effects.json 是效果目录，使用 node scripts/update-effects.js <path to adobe-capability-atlas> 根据能力图谱构建。

审计会依据 After Effects 的脚本对象模型（types-for-adobe，After Effects 26.0）检查每个生成的脚本。目前尚未针对 After Effects 本身进行验证。