ae-mcp

一个用于 Adobe After Effects 的高级 MCP 服务器。它为助手提供了一套编辑器工具包： 读取项目、创建和装配图层、设置带真实速度曲线的关键帧、动画化文本、 构建矢量形状、应用效果和表达式、驱动原生菜单——并通过快照将结果 直接返回到对话中。

架构

Assistant (MCP)
      │  stdio
┌─────▼──────────────────────────────┐
│  ae-mcp server (Node/TypeScript)   │   easing, SVG, presets, schemas
└─────┬──────────────────────────────┘
      │  1. HTTP 127.0.0.1:9782  (CEP transport, primary)
      │  2. watched JSON files    (ScriptUI transport, fallback)
┌─────▼──────────────────────────────┐
│  bridge inside After Effects       │   CEP panel or ScriptUI panel
└─────┬──────────────────────────────┘
      │  $.evalFile + AEMCP.runFile()
┌─────▼──────────────────────────────┐
│  ExtendScript kernel (AEMCP)       │   ~4,000 lines, 60+ commands
└────────────────────────────────────┘

三个原则：

• 繁重的工作留在 Node 中。 SVG 转换、缓动计算、动画预设——全部在 服务端准备；ExtendScript 内核只负责执行。

• 交换通过文件进行。 请求和响应以 JSON 形式存储在磁盘上，避免了 evalScript 的转义和大小限制。HTTP 仅触发运行。

• 一切都是原子的。 每个请求——即使是包含 50 个操作的批处理——都在 单个撤销组内运行：一次 Ctrl+Z 即可全部还原。

桥接认证令牌

CEP 面板的 HTTP 服务器监听 127.0.0.1，并触发 After Effects 中的命令 （包括 ae_eval，它运行任意 ExtendScript）。为了防止在 AE 运行时，浏览器中打开的网页 通过普通的 fetch() 驱动桥接，面板在首次启动时生成一个随机令牌，存储在 Documents/ae-mcp/bridge/token.txt 中，并在 bridge.json（token 字段）中重新发布。 每个 POST /run 或 POST /reload 都必须携带 X-AE-MCP-Token 头；否则服务器返回 401。 MCP 客户端（src/bridge/client.ts）从 bridge.json 读取令牌并自动发送——无需手动设置。 只要 token.txt 存在，令牌就会持续有效；删除它可在下次面板启动时强制重新生成。

回退的文件传输（req//res/）没有令牌：它依赖于用户 Documents 文件夹的 操作系统权限，这些权限已经阻止了来自其他账户的访问。

Related MCP server: After Effects MCP Server

安装

npm install
npm run build
npm run install-bridge      # installs the CEP extension + ScriptUI panel + kernel

然后，在 After Effects 中：

• CEP 传输（推荐） — 重启 After Effects。桥接会自动启动，无需窗口。 Window > Extensions > AE MCP Bridge 显示状态、端口和日志。

• ScriptUI 传输（无需重启） — File > Scripts > Run Script File…，然后选择 Documents/ae-mcp/AE MCP Bridge.jsx。面板会立即开始轮询。

向你的 MCP 客户端注册服务器：

claude mcp add ae-mcp -- node "/path/to/ae-mcp/build/index.js"

npm run install-bridge 还会将面板复制到任何检测到的 After Effects 安装的 Scripts/ScriptUI Panels 中，使其可停靠。该副本位于 Program Files 下， 需要管理员权限；如果失败，其他内容不受影响。

工具

与众不同之处

真实的速度曲线。 ease: "expo.out" 不仅仅应用 Easy Ease——贝塞尔曲线 会被转换为每个维度的影响和速度，根据片段的平均速度计算，就像手动调整 Graph Editor 一样。

相对值。 slideIn 使用 mode: "offset"：动画基于图层的现有位置构建， 而不是覆盖它。缩放同理，使用 mode: "multiply"。

SVG 变成真正的形状。 ae_shape action=svg 将 path、rect、circle、 ellipse、line、polyline、polygon、组及其变换转换为原生、可编辑的 形状图层，填充、描边、虚线和弧线以贝塞尔曲线近似。

视觉反馈循环。 ae_render action=snapshot 渲染合成并直接返回图像： 助手将其输出与参考进行比较并纠正，而不是盲目工作。

带引用的原子批处理。 整个场景在一次往返中构建，每一步都可以通过 {{0.index}} 或 {{prev.id}} 复用前一步的结果。

开发

npm run build          # kernel + TypeScript
npm run build:kernel   # kernel only (also checks its syntax)
node scripts/ae.mjs status                       # bridge status
node scripts/ae.mjs layer.list '{"comp":"My Comp"}'
node scripts/selftest.mjs                        # full validation against AE
node scripts/selftest.mjs --keep --only=shape    # subset, keeps the comp

内核被拆分为 host/kernel/ 下的模块，并由 scripts/build-kernel.mjs 拼接成 host/aemcp-kernel.jsx。它必须保持 ES3 兼容：不能使用 let/const、 不能使用 Array.prototype.map、不能使用原生 JSON（前奏中提供了 polyfill）。

故障排除