架构
工作原理
AE MCP 通过一个轻量级服务器将 Claude 与 After Effects 连接起来,将 AI 的意图转换为 ExtendScript 命令。
MCP 架构
MCP (Model Context Protocol) 是一种开放标准,允许 AI 助手调用外部工具。Synthetic 实现了一个 MCP 服务器,将 270 多个 After Effects 操作公开为可调用工具 —— Claude 会根据您的指令自动选择合适的工具。
数据流
Claude (或 MCP 客户端)
──── MCP 调用 ────▶AE MCP Server
▼ 生成 JSX 脚本
placeholder
──── ExtendScript ────▶Adobe After Effects
▼ 返回 JSON 结果
Claude (或 MCP 客户端)
◀─── JSON 结果 ────AE MCP Server
完整的往返流程 —— 从 Claude 调用工具到 After Effects 执行并返回数据 —— 对于简单操作通常在 1 秒内完成。
什么是 ExtendScript?
ExtendScript 是 Adobe 为 Creative Cloud 应用程序提供的脚本语言。它是一种 JavaScript 方言 (ES3 级别),可以直接访问 After Effects 的对象模型 —— 包括合成、图层、属性、渲染队列以及所有其他内容。
Adobe 自 CS3 (2007) 起就在 After Effects 中支持 ExtendScript。从 After Effects 2021 (CC 2021) 到最新的 2026 版本,每个版本都内置了 ExtendScript 引擎,这就是为什么 AE MCP 可以在所有这些版本中运行而无需任何额外安装。
为什么使用 ExtendScript 而不是 CEP 或 UXP?
| 方法 | 版本 | 需要安装 |
|---|---|---|
| ExtendScript (Synthetic 所使用) | 2021 – 2026+ | 否 — 内置 |
| CEP 面板 | CC 2015 – 2024 | 是 — 必须安装面板 |
| UXP 插件 | 2022+ | 是 — 必须安装插件 |
由于 ExtendScript 已内置在 After Effects 中,因此独立模式无需在 AE 内部安装任何内容。面板模式(macOS 上的默认模式)使用由 Synthetic Setup 为您安装的小型面板。
MCP 服务器如何向 AE 发送脚本
当 Claude 调用工具(例如 create_comp)时,MCP 服务器会:
- 根据工具的 schema 验证输入参数。
- 生成包含相应 ExtendScript 逻辑的 JSX 脚本字符串。
- 将脚本作为临时
.jsx文件交给 After Effects:独立模式下,每次调用都会启动 After Effects 来运行它;面板模式下,由已打开的 After Effects 内的面板执行。 - 读取 AE 写回临时文件的 JSON 响应。
- 将解析后的结果作为工具输出返回给 Claude。
面板模式下 After Effects 必须处于打开状态,且在任何模式下模态对话框都会造成阻塞。如果 AE 显示“保存更改?”提示或任何阻塞对话框,工具调用将超时。
安全模型
MCP 服务器在您的计算机本地运行。您的项目文件、图层名称和合成数据绝不会离开您的电脑。Synthetic 只会通过 api.synthetic.com.ar 验证您的许可证。