@engine-room/after-effects-mcp

中文文档

0.6.1发布于 2026/11/12MITES Module构建来源已验证近 30 天下载 3298

使用AI控制 Adobe After Effect ——描述您想要的动画并被构建:分层,密钥框,效果,表达和文本,之后全部可以编辑.

文档目录12 节

你能用它做什么吗
你需要的东西
开始
1. 安装工具
2. 效应后设立
3. 开始动画
你的家风
更新
安全和隐私
如果出了问题
很高兴知道
对于开发者

影响后 MCP

与AI控制 Adobe 效果后.

描述您想要的动画并在您的工程中构建——分层,键框,放轻松,效果,表达和文本. 所有这一切之后都可以编辑, 和你手工做的一样.

你能用它做什么吗

跟你的人工智能助理说说你给同事做简报的方式:

建一个下三等号 第一编从左边滑入.

让标志弹出一点点过量, 然后保持两秒钟.

这个压缩机的每层应比上面一个更晚地在4个帧中放轻松.

将主压缩器放入生成文件夹 .

它会读取你的comp 在它改变任何事情之前, 使修改成为普通的“ 效果” 工作—— 您可以拖动的键框, 效果你可以拨动—— 并且可以取一个截图来检查它自己的结果。也可以学习您家的风格, 导出 Motion Graphics 模板给 Primee, 放置声音提示, 在背景中渲染 .

六个场景来自一个序列,每个场景的风格不同——通过这些工具所构建的每一个层,键框和效果:

_{标题卡发动机暗色}	_{KPI 网格编辑}
_{NAV曲线 - CRT终端}	_{拨款 - 野蛮人}
_{每月 P&L 数据 - 极光玻璃}	_{奥特罗 - 最小打印数}

你需要的东西

影响到macOS或Windows之后. 2026年"影响后"测试. 面板接受2022年或更晚,但更古老的版本还没有经过测试.
一个在自己的电脑上运行工具的AI应用程序. 这些工具直接在您的机器上与 After Effects 交谈, 因此在任何可以在当地启动 MCP 服务器的应用程序中工作 : 克洛德桌面,克洛德代码, Cursor, VS代码, Codex, Windsurf 和类似.

网络浏览器(claude.ai)和ChatGPT中的克洛德(Claude.ai)——在网络或其应用中——不能使用. 这些只连接到互联网上托管的工具,这些工具无法在您的计算机上到达"事后影响".

开始

三步走,你只做前两步一次.

1. 安装工具

选一个符合你的应用软件的.

克劳德桌面 - 很简单的下载 .mcpb 文件来自最近发布的打开它 Claude Desktop负责其余的工作;没有其他东西可以安装.

克劳德代码

要么安装插件, 并添加技能和斜线命令 :

/plugin marketplace add Engine-Room-Games/after-effects-mcp
/plugin install after-effects@engine-room

或仅添加服务器(需要节点22或稍后):

claude mcp add --scope user after-effects -- npx -y @engine-room/after-effects-mcp

--scope user 提供在每一个文件夹中打开克劳德代码, 不只是当前的一个.

Cursor, Windsurf等应用程序 (需要节点22或更晚)

将此添加到您的应用程序的 MCP 配置中, 然后重新启动该应用程序。在克萨斯州 ~/.cursor/mcp.json (或 .cursor/mcp.json 在Windsurf中,打开其MCP设置并添加到那里.

{
  "mcpServers": {
    "after-effects": {
      "command": "npx",
      "args": ["-y", "@engine-room/after-effects-mcp"]
    }
  }
}

VS 代码 (需要节点22或更晚)

把这个放进去 .vscode/mcp.json,然后重新启动 VS 代码 :

{
  "servers": {
    "after-effects": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@engine-room/after-effects-mcp"]
    }
  }
}

代码 (需要节点22或更晚)

将此添加到 ~/.codex/config.toml数字 :

[mcp_servers.after-effects]
command = "npx"
args = ["-y", "@engine-room/after-effects-mcp"]

没有节点的应用程序 ——独立下载

从最近发布的下载机器的拉链 macos-arm64 (苹果硅), macos-x64 (英特尔麦克)或 windows-x64 ——在任何地方解开它,并将你的应用指向里面的可执行文件:

{
  "mcpServers": {
    "after-effects": {
      "command": "/Users/you/Applications/after-effects-mcp-0.5.2-macos-arm64/after-effects-mcp"
    }
  }
}

未打开的文件夹已命名 after-effects-mcp-<version>-<machine>所以用你实际的名字在 Windows 上,可执行文件是 after-effects-mcp.exe。保持未解析的文件夹在一起。。 macOS构建是签名和公证的;Windows构建是未签名的,因此SmartScreen可能会在您第一次运行时发出警告.

2. 效应后设立

打开后退出效果,然后问你的助手:

设立"影响后".

它将一个小面板安装到"后效应"中,这就是工具如何与之交谈的. 当它完成,打开之后效果,你准备好了.

在面板安装时必须关闭效果后 . 如果打开,安装将不起作用——先退出After Effect,再安装再重开. 稍后更新面板的情况也是如此.

您不必自己打开面板; 它从“ 影响” 之后开始 .

3. 开始动画

打开你的项目,说你想说什么。在任何支持 MCP 提示的应用程序中

提示	它会做什么
`/init-after-effects`	让你通过设置和提议抓住你的风格
`/create-style-guide`	教它你的工作应该是什么样子

有一点要知道: 当一个对话框在After Effects中打开时,那里不会发生其他事,所以工具等待并最终说面板没有及时回答. 关闭对话,工作自行完成——不要再要求了,否则要完成两次.

你的家风

找一个风格导师并指向您已经喜欢的绘图。您的颜色、字体、大小和时间—— 包括您现有的动画如何方便和交错—— 被读出并保存为 house-style.md 在你的旁边 .aep之后建造的一切都跟着它它的平地标记下降, 旅行与项目, 和工作在每个应用程序。 (工程需要保存一次,所以有放入的文件夹

最好的风格指南是具体的—— #131521 at 92% opacity,而不是"黑暗而干净"——最有用的一行是规则:"永远不要将文字直接放入镜头","保持总运行时间在8秒以内".

你也可以请它 设置工程文件夹 视频、系列或客户端: 您的助手读取的简报, a renders/ 文件夹,而无论哪个规则文件您的应用程序读取( e)AGENTS.md, (中文(简体) ), CLAUDE.md, (中文(简体) ), .cursor/rules/ (见A/CN.9/WG.III/WP.III/WP.1号文件)。从一个终端它 npx @engine-room/after-effects-mcp init my-video。更新工具时绝不触及任何文件.

更新

两块分别更新,以及 效果后, 内置面板不更新自身数字 :

工具重新安装 .mcpb,下载新的独立构建,或者在使用时重新启动您的应用程序 npx在 Claude 代码插件上,运行 /plugin marketplace update engine-room 财务报告和审定财务报表 /plugin update after-effects@engine-room,然后重新启动 Claude 代码.
小组 ——退出“效果”后,请您的助手 更新效果面板,然后在“效果”之后重新打开.

忘记第二步,没有什么会悄悄地破裂:你的下个请求在结束时,会清楚地解释该怎么做.

之后,运行 /absorb-release 在您的工程文件夹( 其他应用程序列表为 absorb-release 在他们的快速菜单。它忽略了早期会议的任何工作写进你的项目说明新的版本使得没有必要.

安全和隐私

只有你自己的电脑才能和"影响之后"说话. 面板听着 127.0.0.1 ——你的机器,永远不要你的网络——每个请求都必须携带一个密钥,每一次在"影响"开始后,面板都会新鲜出. 没有它,什么都没有运行.
更改是普通倒置步骤 . Cmd/Ctrl+Z工作于你的助手所做的,就像在自己的编辑上一样. 在支持它的应用程序中,删除一个压缩件,清理未使用的相片或者返回压缩件会先询问您.
你的助手看到的都是你使用的人工智能模型 ——您的工程中的图层名称,文本,密钥框,文件路径,以及您的comp的截图. 如果一个项目是保密的,那么将一个会话当作粘贴到聊天中.

两个可选开关限制了它所能做的. 都关了除非你打开.

切换	它会做什么
只读模式	您的助手可以查看您的项目——列表压缩和分层,读取密钥框,取取截图——但是每一个改变某物的工具都被取出.
关闭运行中的脚本	删除 `run_jsx`,该工具允许您的助手编写并运行自己的"影响后"脚本. 其他一切仍然有效,包括渲染;只有工作没有其他工具封面(如替换或再链接镜头)成为不可能.

如何打开它们

克劳德桌面 : 设置 → 扩展 → 效果后, 然后勾选 只读模式 或者说 关闭运行的脚本( run jsx)。。。 .

其他任何地方: 将设置从第1步添加到配置中,然后重新启动您的应用程序。单独使用任意一种;只读模式已经包括第二种模式.

应用	怎么样
光标、风浪等 `mcpServers` 应用程序	添加 `"env": { "AE_MCP_READ_ONLY": "1", "AE_MCP_DISABLE_RUN_JSX": "1" }` 旁边 `"command"` 财务报告和审定财务报表 `"args"`。。。 .
VS 代码	一样 `"env"` 块,在 `after-effects` 条目 `"servers"` 内 `.vscode/mcp.json`。。。 .
代码	添加一节到 `~/.codex/config.toml`数字 : `[mcp_servers.after-effects.env]` `AE_MCP_READ_ONLY = "1"`
克劳德代码	用设置重新添加服务器 : `claude mcp remove after-effects`,则 `claude mcp add --scope user --env AE_MCP_READ_ONLY=1 after-effects -- npx -y @engine-room/after-effects-mcp`

例如,在 mcpServers 应用 :

{
  "mcpServers": {
    "after-effects": {
      "command": "npx",
      "args": ["-y", "@engine-room/after-effects-mcp"],
      "env": {
        "AE_MCP_READ_ONLY": "1",
        "AE_MCP_DISABLE_RUN_JSX": "1"
      }
    }
  }
}

一个关机工具根本不存在所以你的助手不会尝试并且会在需要的时候告诉你开关只限制这种连接——它们不会锁定"后效应"(After Effects),另一个没有它们连接的助手仍然拥有每一个工具.

如果出了问题

请您的助手检查效果后设置 . 它发现哪一部分被打破并告诉你该怎么做,用简单的语言.

特定错误信息、较长时限、问题笔记本和如何报告错误,请参见解决问题欢迎错误报告问题 ——macOS是两个平台中测试较多的,因此Windows特别报告.

很高兴知道

未涵盖的内容: 替换或重新连接相片(包含导入),以及“影响”本身的偏好.
截图用于抽查. 阿尔法边缘在一些comp中可能略为不完美.
自定义脚本中的长回路在效果后被冻结 直到它结束。工作很繁重 run_batch,没有.
面板签名,所以在效果之后,没有Adobe的加载 PlayerDebugMode 设置。设置仍然打开该设置为倒计时; 它适用于您的整个用户账户, 让 Adobe 应用程序加载任意未签名面板。从git取出时安装的面板没有签名,确实需要.
全部删除 : 见未加载,它也覆盖了调试器的关闭.
列出的每个工具: 见工具 ——有89个,加上一些应用节目的外加,如交互式压缩时段.

对于开发者

git clone https://github.com/Engine-Room-Games/after-effects-mcp.git
cd after-effects-mcp
npm install && npm run build
npm run install:panel
npm run doctor

make help 列出其余部分(make jsx hot- reloads 扩展脚本捆绑成运行后效果; make release ”)。开始克劳德·姆德结构、公约和如何增加工具文档/ 脆弱地区和现场核查方法。代理指南写入一次 packages/mcp-server/src/{guides,prompts}/*.md 并随处生成——从不编辑生成的拷贝. 构建自己二进制的叉会得到未签名的;macOS会拒绝它们,直到它们与自己的开发者ID签名.

_{由发动机室自由和开放源码——如果它能节省你的时间, 赞助其发展}

版本与发布记录

@engine-room/after-effects-mcp 共发布 13 个版本，首次发布于 2026/08/10；过去 12 个月发布了 13 个版本。最新版本附带 npm provenance 构建来源证明，可追溯到公开的 CI 构建记录。

版本	发布日期	距今
`0.6.1`latest	2026/11/12	1 天前
`0.6.0`	2026/11/08	6 天前
`0.5.2`	2026/10/29	15 天前
`0.5.1`	2026/09/16	1 个月前
`0.5.0`	2026/09/09	2 个月前
`0.4.0`	2026/08/31	2 个月前

关于 @engine-room/after-effects-mcp 的常见问题

@engine-room/after-effects-mcp 是什么？

使用AI控制 Adobe After Effect ——描述您想要的动画并被构建:分层,密钥框,效果,表达和文本,之后全部可以编辑.

如何安装 @engine-room/after-effects-mcp？

在项目目录运行 npm install @engine-room/after-effects-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 after-effects-mcp，可以用 npx after-effects-mcp 直接运行。

@engine-room/after-effects-mcp 支持 TypeScript 吗？

该包的 package.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/engine-room__after-effects-mcp 是否存在。

@engine-room/after-effects-mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。

@engine-room/after-effects-mcp 需要什么版本的 Node.js？

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

@engine-room/after-effects-mcp 可以商用吗？

@engine-room/after-effects-mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

@engine-room/after-effects-mcp 的下载量有多少？

根据 npm 官方下载统计，@engine-room/after-effects-mcp 在 2026/10/14 – 2026/11/12 这 30 天内被下载 3,298 次，日均约 110 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

@engine-room/after-effects-mcp 还在维护吗？

最新版本 0.6.1 发布于 2026/11/12（1 天前）；至今共发布 13 个版本，其中过去 12 个月发布了 13 个；首次发布于 2026/08/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

npm install @engine-room/after-effects-mcp

pnpmpnpm add @engine-room/after-effects-mcp
yarnyarn add @engine-room/after-effects-mcp
bunbun add @engine-room/after-effects-mcp

命令行npx after-effects-mcp

在你的项目目录中运行此命令。

近 30 天下载

3,298

约 3298 次日均 110 次

统计周期 2026/10/14 – 2026/11/12
数据来自 npm 官方下载统计，今天更新

最新版本0.6.1发布于 1 天前

开源许可MIT宽松许可

包体积1.7 MB35 个文件 · 解压后

运行依赖3 个

模块格式ES Module

TypeScript未声明类型可查找 @types/engine-room__after-effects-mcp

Node.js>=22

发布版本13 个近 12 个月 13 个

首次发布2026/08/103 个月前

元数据更新2026/11/12

每一个软件包背后，
都有分享与创造的人。