# @engine-room/after-effects-mcp 中文文档
规范地址：https://npmcn.com/package/%40engine-room/after-effects-mcp/
版本：0\.6\.1
npm 元数据更新时间：2026-11-11T19:35:32.094Z
中文译文更新时间：2026-11-13T17:55:06.475Z
软件包许可：MIT
本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。
原始 npm 页面：https://www.npmjs.com/package/%40engine-room/after-effects-mcp
原文对照：https://npmcn.com/package/%40engine-room/after-effects-mcp/?lang=original
项目主页：https://github.com/Engine-Room-Games/after-effects-mcp#readme
源码仓库：https://github.com/Engine-Room-Games/after-effects-mcp
## 关键信息（来自 npm 元数据）
- 包体积（解压后）：1.7 MB，35 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：3 个
- 首次发布：2026-08-10T14:22:35.329Z
- 最新版本发布：2026-11-11T19:35:31.694Z
- 近 30 天下载量：3298（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：13（近 12 个月 13 个）
## 中文简介
使用AI控制 Adobe After Effect ——描述您想要的动画并被构建:分层,密钥框,效果,表达和文本,之后全部可以编辑.
## 安装
```sh
npm install @engine-room/after-effects-mcp
```
也可以使用：`pnpm add @engine-room/after-effects-mcp`、`yarn add @engine-room/after-effects-mcp`、`bun add @engine-room/after-effects-mcp`
## README
# 影响后 MCP
**与AI控制 Adobe 效果后.**
描述您想要的动画并在您的工程中构建——分层,键框,放轻松,效果,表达和文本. 所有这一切之后都可以编辑, 和你手工做的一样.
[](https://www.npmjs.com/package/@engine-room/after-effects-mcp) [](https://github.com/Engine-Room-Games/after-effects-mcp/actions/workflows/ci.yml) [](https://github.com/Engine-Room-Games/after-effects-mcp/blob/main/LICENSE) [](https://www.adobe.com/products/aftereffects.html)  [](https://github.com/sponsors/migus88)
## 你能用它做什么吗
跟你的人工智能助理说说你给同事做简报的方式:
> 建一个下三等号 _第一编_从左边滑入.
> 让标志弹出 一点点过量, 然后保持两秒钟.
> 这个压缩机的每层应比上面一个更晚地在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` 文件来自 [最近发布的](https://github.com/Engine-Room-Games/after-effects-mcp/releases/latest) 打开它 Claude Desktop负责其余的工作;没有其他东西可以安装.
**克劳德代码**
要么安装插件, 并添加技能和斜线命令 :
```
/plugin marketplace add Engine-Room-Games/after-effects-mcp
/plugin install after-effects@engine-room
```
或仅添加服务器(需要节点22或稍后):
```bash
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设置并添加到那里.
```json
{
"mcpServers": {
"after-effects": {
"command": "npx",
"args": ["-y", "@engine-room/after-effects-mcp"]
}
}
}
```
**VS 代码** (需要节点22或更晚)
把这个放进去 `.vscode/mcp.json`,然后重新启动 VS 代码 :
```json
{
"servers": {
"after-effects": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@engine-room/after-effects-mcp"]
}
}
}
```
**代码** (需要节点22或更晚)
将此添加到 `~/.codex/config.toml`数字 :
```toml
[mcp_servers.after-effects]
command = "npx"
args = ["-y", "@engine-room/after-effects-mcp"]
```
**没有节点的应用程序** ——独立下载
从 [最近发布的](https://github.com/Engine-Room-Games/after-effects-mcp/releases/latest)下载机器的拉链 `macos-arm64` (苹果硅), `macos-x64` (英特尔麦克)或 `windows-x64` ——在任何地方解开它,并将你的应用指向里面的可执行文件:
```json
{
"mcpServers": {
"after-effects": {
"command": "/Users/you/Applications/after-effects-mcp-0.5.2-macos-arm64/after-effects-mcp"
}
}
}
```
未打开的文件夹已命名 `after-effects-mcp--`所以用你实际的名字 在 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`。更新工具时绝不触及任何文件.
## 更新
两块分别更新,以及 **效果后, 内置面板不更新自身**数字 :
1. **工具** 重新安装 `.mcpb`,下载新的独立构建,或者在使用时重新启动您的应用程序 `npx`在 Claude 代码插件上,运行 `/plugin marketplace update engine-room` 财务报告和审定财务报表 `/plugin update after-effects@engine-room`,然后重新启动 Claude 代码.
2. **小组** ——退出“效果”后,请您的助手 _更新效果面板_,然后在“效果”之后重新打开.
忘记第二步,没有什么会悄悄地破裂:你的下个请求在结束时,会清楚地解释该怎么做.
之后,运行 `/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` 应用 :
```json
{
"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),另一个没有它们连接的助手仍然拥有每一个工具.
## 如果出了问题
**请您的助手检查效果后设置 .** 它发现哪一部分被打破 并告诉你该怎么做,用简单的语言.
特定错误信息、较长时限、问题笔记本和如何报告错误,请参见 [解决问题](https://github.com/Engine-Room-Games/after-effects-mcp/blob/main/docs/troubleshooting.md)欢迎错误报告 [问题](https://github.com/Engine-Room-Games/after-effects-mcp/issues) ——macOS是两个平台中测试较多的,因此Windows特别报告.
## 很高兴知道
- **未涵盖的内容:** 替换或重新连接相片(包含导入),以及“影响”本身的偏好.
- **截图用于抽查.** 阿尔法边缘在一些comp中可能略为不完美.
- **自定义脚本中的长回路在效果后被冻结** 直到它结束。 工作很繁重 `run_batch`,没有.
- **面板签名**,所以在效果之后,没有Adobe的加载 `PlayerDebugMode` 设置。 设置仍然打开该设置为倒计时; 它适用于您的整个用户账户, 让 Adobe 应用程序加载 _任意_ 未签名面板 。 从git取出时安装的面板没有签名,确实需要.
- **全部删除 :** 见 [未加载](https://github.com/Engine-Room-Games/after-effects-mcp/blob/main/docs/uninstalling.md),它也覆盖了调试器的关闭.
- **列出的每个工具:** 见 [工具](https://github.com/Engine-Room-Games/after-effects-mcp/blob/main/docs/tools.md) ——有89个,加上一些应用节目的外加,如交互式压缩时段.
## 对于开发者
```bash
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` ”)。 开始 [克劳德·姆德](https://github.com/Engine-Room-Games/after-effects-mcp/blob/main/CLAUDE.md) 结构、公约和如何增加工具 [文档/](https://github.com/Engine-Room-Games/after-effects-mcp/tree/main/docs) 脆弱地区和现场核查方法。 代理指南写入一次 `packages/mcp-server/src/{guides,prompts}/*.md` 并随处生成——从不编辑生成的拷贝. 构建自己二进制的叉会得到未签名的;macOS会拒绝它们,直到它们与自己的开发者ID签名.
* * *
由 [发动机室](https://github.com/Engine-Room-Games) 自由和开放源码——如果它能节省你的时间, [赞助其发展](https://github.com/sponsors/migus88)
## 常见问题
### @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 和提交记录判断。