AfterEffects-MCP-IMT + SKILLS — After Effects for AI agents

AfterEffects-MCP-IMT + SKILLS — 面向 AI Agent 的 After Effects，安全可靠，可放心交由 AI 操作

让 AI 助手（Claude Desktop、Cursor、ChatGPT、Google Antigravity 或任何 MCP 客户端）在正在运行的 Adobe After Effects 中工作：通过自然语言读取项目、创建和编辑合成、图层、效果、关键帧、文本、蒙版和表达式，并渲染检查帧。

支持所有 Adobe 界面语言 · 丰富的技能库 · 专为 AI 和生成式功能打造。 AfterEffects-MCP-IMT 支持 Adobe 发布的所有界面语言，内置丰富的技能库，并针对 Adobe 的 AI 和生成式功能打造——包括 Roto Brush 和 Object Matte、内容识别填充，以及将生成的图像源作为原生图层进行动画制作。

两部分协同工作：

• MCP 服务——约 270 个小型、安全的操作，封装在两个工具中，并提供试运行、每次调用一个撤销组、检查点、项目锁和明确的错误信息。
• 技能（skills/ae）——Agent 应该_了解_的内容：工作顺序、脚本在 After Effects 中无法完成的操作及其安全的解决方法、分步教程（摄像机跟踪、在素材上添加 3D 内容、插件测试、渲染、动态图形、蒙版）以及插件知识文件。

专为本地化版 After Effects 打造，而不只针对英文版。 大多数 Adobe 应用的 MCP 服务和 Agent 技能都假定界面为英文——在德语、日语或俄语版本中，效果、模板和菜单名称就无法匹配。AfterEffects-MCP-IMT 使用 After Effects 自身的标识符（matchNames、命令 ID）定位 After Effects，并通过 After Effects 自带的词典翻译英文模板名称，因此同一个 Agent 和同一项技能可在 After Effects 支持的所有界面语言中使用——已通过实时验证。

由 Immersive Media Technologies 开发。

macOS 和 Windows · After Effects 2024–2026（已在两种系统上的 26.5 版本中验证，支持所有界面语言）· Node.js 22+（使用 Claude Desktop 扩展时无需安装——已在 macOS 和 Windows Store 版 Claude Desktop 上验证）。

注意

此工具会编辑真实的 After Effects 项目，并将项目内容（名称、表达式、素材路径、渲染预览）发送到你使用的 AI 服务。请在副本上操作；处理 NDA 项目时，请查看服务提供商的数据政策；除非需要直接执行脚本，否则请保持 AE_MCP_ENABLE_EVAL 关闭。

可以提出的请求

• “指出这个项目中的所有问题——缺失的素材、字体、表达式错误。”
• “为 Intro 中的每个文本图层添加辉光，效果比现在弱 30 %，并显示第 2.0 帧。”
• “导入这个 Illustrator 文件，并使用文本弹出预设为标题制作动画。”
• “跟踪这个片段中的摄像机，在地面上放置一个 3D 空对象，并将徽标设为它的父级。” (技能)
• “这是一帧参考画面：用原生元素制作这个下三分之一标题，添加 Speed 滑块，并将文本放入 Essential Graphics。” (技能)
• “在纯色层上测试这个插件，导出其参数，渲染一帧，并告诉我它是否正常工作。” (技能)

Agent 会自行组合这些操作，并在每个步骤之间检查项目；技能则会引导它按正确流程操作。

安装

你需要在这台电脑上运行 After Effects，并授予以下两项权限：

• **macOS — 自动化：**首次调用时，系统会询问是否允许你的 AI 客户端控制 After Effects（如果拒绝，稍后会出现错误 −1743：系统设置 → 隐私与安全性 → 自动化）。
• **脚本文件访问权限：**After Effects → 设置 → 脚本与表达式 → 允许脚本写入文件并访问网络。 | 客户端 | 操作 | | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Claude Desktop | 下载 aftereffects-mcp-imt.mcpb，双击并点击 Install（Windows：将其拖到 Settings → Extensions）。无需 Node。 | | Cursor | 添加到 Cursor — 一键操作：Cursor 会打开并写入配置（也可以将下面的代码片段放入 ~/.cursor/mcp.json）。 | | Google Antigravity | Settings → Customizations → Installed MCP Servers → View raw config → 添加下面的代码片段。 | | ChatGPT（仅限远程服务） | 在 After Effects 所在的计算机上运行：npx -p @immersive-media-technologies/aftereffects-mcp-imt aftereffects-mcp-imt-chatgpt — 它会通过隧道启动服务，并打印可粘贴到 ChatGPT 的 URL。 | | 任何 MCP 客户端 | 将下面的代码片段放入其 mcpServers 中。 |

{
  "mcpServers": {
    "aftereffects": {
      "command": "npx",
      "args": ["-y", "@immersive-media-technologies/aftereffects-mcp-imt"],
      "env": { "MCP_TIMEOUT": "120000" }
    }
  }
}

从源代码安装并进行实时自测（我们采用的方式）：

git clone https://github.com/Immersive-Media-Technologies/aftereffects-mcp-imt.git
cd aftereffects-mcp-imt && ./install.sh        # Windows: .\install.ps1

安装程序会检查 After Effects 和 Node，执行构建，向正在运行的 AE 发送 ping，并指出问题所在 （−1743、脚本访问权限、Node 路径）；征求同意后，还会将配置项写入 Claude Desktop、 Cursor 和 Antigravity 的配置文件，并备份这些文件。

如果无法连接

• macOS 上出现 spawn npx ENOENT：GUI 应用看不到 shell 的 PATH——用 Homebrew 或 nodejs.org 安装的 Node 的绝对路径替换 npx（它们看不到 nvm 的 Node）。
• 将 MCP_TIMEOUT 设为 120000：After Effects 冷启动耗时超过默认的 30 s。
• 超时并显示 DIALOG_OPEN 消息：After Effects 正在显示对话框（保存提示、缺失素材、插件警告）——错误信息会引用对话框内容；Agent 可以用 ae_dialogs 关闭它，也可以由你手动关闭。在 macOS 上，读取和关闭对话框需要客户端应用获得辅助功能权限。
• Windows：如果 After Effects 不在 C:\Program Files\Adobe 下，AE_MCP_EXE 必须指向 AfterFX.exe。没有受支持的 GPU（例如在虚拟机中）：先关闭「System Compatibility Report」。机器上无需安装 Node.js 即可使用 .mcpb——Claude Desktop 会使用内置的 Node（已在 Windows 11 ARM 上通过 Microsoft Store 版本验证）。服务日志：%LOCALAPPDATA%\Claude\logs\mcp-server-<name>.log；邮箱：%TEMP%\mcp-aftereffects。
• 如果客户端限制工具输出长度，请将上限提高到 50 000——在真实项目中，ae_project_info 的输出会超过常见的 25 000。

如何确保安全

试运行	ae_do {dryRun: true} 会显示_将要_运行的 ExtendScript，且绝不会触及 After Effects。
每次调用一个撤销组	每个 ae_do——即使是包含 30 个步骤的 batch.run——都只需按一次 Cmd+Z 即可撤销。batch.run {atomic: true} 在某个步骤失败时会自行撤销，并报告结果（rollback.verified）。
检查点	project.checkpoint 会在项目旁保存一份 .aep 副本；project.revert 可在崩溃、重新启动或误操作后恢复项目——这些情况无法通过撤销处理。
项目锁定	AE_MCP_PROJECT_LOCK=/path/to/one.aep——Agent 只能更改该项目；你打开的其他项目不会受到影响。
只读模式	首次使用时设置 AE_MCP_READONLY=1：只能检查和查看帧。
如实报告错误	每次失败都会提供错误代码（DIALOG_OPEN、TIMEOUT、INVALID_ARGS、OPERATION_FAILED 等）和提示；批处理会报告失败步骤。
不在 AE 内安装任何内容	服务从外部与 After Effects 通信（osascript / AfterFX.exe -r）；卸载时只需删除文件夹。

如果需要在客户端限制操作，请禁止那些无法通过 Cmd+Z 撤销的操作：eval.run、project.new / open / revert、清理／整合操作、pref.*、render.start。完整列表和参考实现见 docs/AGENT-POLICY.md。

Agent 如何查看项目

• ae_project_info / ae_comp_info / ae_layer_info——需要时获取完整概况。
• comp.snapshot → 编辑 → comp.diff——编辑前后进行轻量指纹对比：哪些图层被添加、移除或更改，以及具体改动。只需几十个 token 即可验证。
• ae_render_frame——生成 Agent 可查看的 PNG；将 compareWith 指向较早的帧，无需打开图像即可了解“画面是否发生变化，以及变化位置”。
• property.sample——一次调用即可获取摄像机在开始、中间和结束时的位置／朝向／缩放；expression.validate 和 project.audit——在用户点击播放前检查错误。

技能

skills/ae/SKILL.md 是 Agent 首先读取的简短路由文件；它会指向任务所需的一个文件：

SKILL.md	调用预算（是什么让一次实时插件测试每小时耗费 76 次调用，以及如何避免）、工作顺序（了解状态 → 创建检查点 → 操作 → 先按数值验证，再按画面验证），以及一张列出 脚本在 After Effects 中无法完成的操作及其安全替代方案的表格。
recipes/camera-track.md	3D Camera Tracker 端到端流程：从菜单启动分析，一次调用等待，使用真实点击按下「Create Camera」（合成点击会导致 AE 26.5 崩溃），设置地平面，并以数值读取摄像机数据。
recipes/attach-3d.md	将 splat、模型或纯色图层放到已跟踪的素材上：原点空对象、父子关系或表达式、缩放，以及一段测量像素偏移而非凭目测判断的脚本。
recipes/plugin-test.md	测试第三方插件：安装前检查文件，应用到纯色图层，通过 matchName 导出参数，将模型图层提供给插件，渲染、计时并写下结论。
recipes/render.md	帧、分段渲染、本地化 AE 中的模板，以及文件保存位置。
recipes/motion-graphics.md	将标题、字幕条、Logo 动效、信息图制作成可编辑的 AE 合成：拆解表、CONTROLS 控制装置、真实缓动、Essential Graphics，以及每个阶段对应的一帧。
recipes/masks-roto.md, recipes/tracking-mocha.md	遮罩和轨道遮罩、Object Matte / Roto Brush、Tracker 面板和 Mocha——哪些操作应由脚本执行，哪些需要用户点击。
plugins/<name>.md	每个插件对应一个知识文件（matchNames、输入方式、仅限 UI 的操作、特性、耗时）。首先介绍 irrealix Gaussian Splatting。模板见 plugins/README.md。
scripts/	仅包含脚本无法完成的 UI 步骤：硬件级鼠标事件、窗口和显示器几何信息、按本地化名称点击菜单、对话框、一次调用等待分析完成、截图、帧序列、偏移测量。没有脚本会重复服务器操作。
将其用作支持技能的客户端中的技能（把 skills/ae 复制到 ~/.claude/skills/，或让系统提示词指向 SKILL.md）。动态图形制作方案会跳转到五套开源 MIT 技能集中的主题参考；这些内容会在运行时获取，不会随包捆绑——运行一次 skills/ae/fetch-vendor.sh 即可。

工具

工具	用途
ae_catalog / ae_do	发现操作（24 个类别）并运行一个操作，或在一次 batch.run 中运行多个操作
ae_project_info / ae_comp_info / ae_layer_info / ae_version_info / ae_context	读取
ae_render_frame	将单帧渲染为 PNG（颜色与查看器一致；使用 compareWith 获取指标）
ae_save_project, ae_project_export_json / ae_project_import_json	保存；对整个项目进行 JSON 往返处理
ae_dialogs	查看并关闭阻止脚本运行的模态对话框

包含参数的完整列表：docs/TOOLS.md；运行时可通过 ae_catalog 查看操作。

变量	默认值	含义
AE_MCP_EXE	自动检测	After Effects .app 程序包（macOS）或 AfterFX.exe（Windows）
AE_MCP_READONLY	关闭	1 → 不允许修改项目
AE_MCP_PROJECT_LOCK	关闭	Agent 可以修改的唯一 .aep 文件路径
AE_MCP_CHECKPOINT_DIR	项目旁边	project.checkpoint 保存副本的位置
AE_MCP_ENABLE_EVAL	关闭	1 → 启用 eval.run（任意 ExtendScript）
AE_MCP_ALLOW_CATEGORIES	全部	以逗号分隔的允许操作类别列表
AE_MCP_RUNTIME_DIR	OS 临时目录	IPC 邮箱所在位置
MCP_TIMEOUT	客户端	在客户端配置中设置为 120000

为什么选择这个

After Effects MCP 服务有好几个；大多数只做到“AI 可以运行 ExtendScript”。这个服务围绕自主 Agent 的需求构建，同时也考虑到交接项目的人员需要什么：精简稳定的工具接口（两个工具，而不是 270 个）、真正的试运行、安全可撤销的操作、检查点和项目锁、清晰准确的错误信息、能指出问题所在的安装程序，以及一项技能，教会 Agent 掌握 After Effects 中 API 未覆盖的部分——无论 After Effects 使用哪种 UI 语言都适用，而大多数服务只支持英文界面。已在 AE 2026、macOS 和 Windows 上验证。

发布

每个版本都在 发布 页面中介绍； 所有变更都记录在 CHANGELOG.md 中。上游修复按主题从 kumoproductions/mcp-aftereffects 合并。

• v1.0.2 · 2026-10-28 — 全面完善描述：支持所有 Adobe UI 语言，提供大型技能库，并针对 Adobe 的生成式功能构建。
• v1.0.1 · 2026-10-28 — 产品名称改为 AfterEffects-MCP-IMT（原为 AE-MCP-IMT）；服务名称改为 aftereffects-mcp-imt，与 npm 包名称一致；MCP Registry 条目也列出了 npm 包。
• v1.0.0 · 2026-10-28 — 支持所有 After Effects UI 语言（通过 After Effects 的 字典获取 matchNames、命令 id 和模板名称；已进行实时验证），修正命令列表，采用 Apache-2.0 许可。
• v0.5.5 · 2026-10-11 — After Effects 技能（skills/ae）、检查点和还原、原子批处理、合成快照和差异、 表达式验证、项目审计、对话框检测、项目锁定、帧对比。
• v0.4.4 · 2026-10-04 — Windows：支持从 Microsoft Store 安装的 Claude Desktop。
• v0.4.3 · 2026-10-04 — 已验证 Windows 支持（使用 AfterFX.exe -r 启动路径）。
• v0.4.2 · 2026-10-01 — 修复 ChatGPT 网关；v0.4.1 — 通过一条命令使用 ChatGPT； v0.4.0 — 一键安装（.mcpb、Cursor、npm、安装程序）。
• v0.3.5 · 2026-09-30 — AE Motion 技能；v0.3.0 — IMT 分支首次公开发布。

给贡献者的说明：离线传输测试（npm test）要求 macOS 上的 After Effects 处于关闭状态——如果它处于打开状态，正在运行的 AE 会响应测试替身请求，导致其中几个测试失败。

许可证

Apache License 2.0 — © Immersive Media Technologies。

• 可免费使用、修改和分发，包括商业用途。
• 必须注明出处。 每次重新分发本软件或其衍生作品时， 都必须附上 NOTICE 中的声明： AfterEffects-MCP-IMT by Immersive Media Technologies — https://github.com/Immersive-Media-Technologies。
• 不提供任何担保。

第三方声明（上游 MIT 代码）：THIRD-PARTY-NOTICES.md。