架构
工作原理
AE MCP 通过一个轻量级服务器将 Claude 与 After Effects 连接起来，将 AI 的意图转换为 ExtendScript 命令。
MCP 架构
MCP (Model Context Protocol) 是一种开放标准，允许 AI 助手调用外部工具。Synthetic 实现了一个 MCP 服务器，将 220 多个 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。从 CS6 到最新的 2026 版本，每个版本都内置了 ExtendScript 引擎，这就是为什么 AE MCP 可以在所有这些版本中运行而无需任何额外安装。
为什么使用 ExtendScript 而不是 CEP 或 UXP？
| 方法 | 版本 | 需要安装 |
|---|---|---|
| ExtendScript (Synthetic 所使用) | CS6 – 2026+ | 否 — 内置 |
| CEP 面板 | CC 2015 – 2024 | 是 — 必须安装面板 |
| UXP 插件 | 2022+ | 是 — 必须安装插件 |
由于 ExtendScript 已内置在 After Effects 中，因此无需在 AE 内部安装任何内容。只需打开 After Effects 即可准备就绪 —— 其余工作由外部的 MCP 服务器处理。
MCP 服务器如何向 AE 发送脚本
当 Claude 调用工具（例如 create_comp）时，MCP 服务器会：
- 根据工具的 schema 验证输入参数。
- 生成包含相应 ExtendScript 逻辑的 JSX 脚本字符串。
- 通过
doScript基于文件的 IPC 机制将脚本发送至 After Effects（写入临时.jsx文件并通知 AE 执行）。 - 读取 AE 写回临时文件的 JSON 响应。
- 将解析后的结果作为工具输出返回给 Claude。
After Effects 必须处于打开状态且未被模态对话框阻塞，MCP 才能与其通信。如果 AE 显示“保存更改？”提示或任何阻塞对话框，工具调用将超时。
安全模型
MCP 服务器在您的本地机器上运行 —— 运行时不会将任何数据发送到 Synthetic 的服务器。您的项目文件、图层名称和合成数据永远不会离开您的计算机。唯一的网络调用是在服务器启动时向 api.synthetic.com.ar 进行的一次性许可证验证。