After Effects MCP服务器
](https://nodejs.org)   
从AI助手和应用程序控制Adobe After Effects 通过 模型上下文协议通过自然语言或任何MCP客户端创建构图、图层、关键帧、效果和完整视频项目。
______________________________________________________________________
目录
______________________________________________________________________
特性
122工具 · 5资源 · 8个提示
| 区域 | 能力 |
|---|---|
| 项目 | 创建、打开、保存;设置(位深度、颜色空间);删除/重命名项目;删除未使用的镜头;收集文件 |
| 作品 | 创建、复制、, 按名称或索引删除,重命名;工作区;选定层;运动模糊、3D、帧混合 |
| 图层 | 文本、形状、实体、调整、零点、相机、灯光、音频;复制、删除、重命名、移动、拆分、父级、预压缩 |
| 变换 | 位置、比例、旋转(2D/3D);中心/适合比赛;材料选择;混合模式;轨道床垫 |
| 动画 | 关键帧;放宽预设;运动路径;淡入淡出/滑动/缩放/旋转/模糊预设;交错;表达式模板 |
| 效果 | 按匹配名称申请;模板(发光、模糊、颜色等);预设;动画效果属性 |
| 口罩 | 矩形、椭圆形、路径;羽毛,不透明,膨胀;遮罩显示动画 |
| 形状 | 路径、修改器(修剪、重复、摆动等);变形 |
| 渲染 | 添加到队列;开始渲染;导出H.264、ProRes;单帧 |
| 导入 | 导入文件;替换镜头;解读;重载;缺失镜头列表 |
| 场景和渲染 | 获取场景摘要、获取渲染进度、获取图层树、设置项目、列出可用字体、获取/设置关键帧插值 |
| 视口/视野 | 获取视口屏幕截图 –将当前comp捕获为PNG,以便AI可以“看到”场景(如 搅拌机MCP 视口截图) |
看 docs/COMPLETE_food_COVERAGE.md 和 docs/BLENDER_MCP_COMPARISON_AND_ROADMAP.md 全面覆盖。
______________________________________________________________________
先决条件
- Adobe After Effects 2022年或以后
- Node.js 18岁或以后
- npm (或纱线)
______________________________________________________________________
快速启动
git clone https://github.com/Dakkshin/after-effects-mcp.git
cd after-effects-mcp
npm install
npm run build然后将桥接器安装到After Effects中(参见 安装),配置MCP客户端 MCP_AE_BRIDGE_DIR,打开 mcp-bridge-auto.jsx AE中的面板,启用 自动运行命令,并开始从您的AI客户端发送命令。
______________________________________________________________________
安装
1.克隆和构建
git clone https://github.com/Dakkshin/after-effects-mcp.git
cd after-effects-mcp
npm install
npm run build窗户: 如果 npm run build 复制、使用失败 npm run build:win 相反。
2.安装After Effects桥
MCP服务器通过以下方式与After Effects通信 桥牌脚本 必须位于AE的ScriptUI Panels文件夹中。
| 平台 | 命令 | 注释 |
|---|---|---|
| macOS | ./install-bridge-mac.sh | 用途 sudo;安装到AE 2026中。系统将提示您输入密码。 |
| 视窗 | npm run install-bridge | 复制到第一个检测到的AE版本。如果遇到权限错误,请以管理员身份运行。 |
| macOS(无sudo) | npm run install-bridge | 尝试在没有sudo的情况下进行复制;如果失败,请使用 install-bridge-mac.sh. |
代码更改后重新安装: 跑 npm run build,然后再次运行安装步骤(例如。 npm run install-bridge 或 ./install-bridge-mac.sh).
3.允许在After Effects中使用脚本
- 后期特效 (macOS)或 编辑 (Windows)→ 偏好 → 脚本和表达式
- 启用 允许脚本写入文件和访问网络
- 点击 好的 并在收到提示时重新启动After Effects
没有这个,网桥将无法读取/写入命令文件。
4.一个命令设置(可选)
- macOS/Linux:
./setup.sh--安装deps、构建并运行网桥安装程序 - 窗户:
setup.bat--同样的想法
______________________________________________________________________
MCP客户端配置
将服务器添加到MCP配置中(例如Cursor、Claude Desktop)。使用 绝对路径 到 build/index.js 并设置 网桥目录 因此服务器和After Effects使用相同的文件夹。
示例(光标 mcp.json 或设置):
{
"mcpServers": {
"AfterEffectsMCP": {
"command": "node",
"args": ["/absolute/path/to/after-effects-mcp/build/index.js"],
"env": {
"MCP_AE_BRIDGE_DIR": "/Users/YOUR_USERNAME/.after-effects-mcp"
}
}
}
}- 替换
/absolute/path/to/after-effects-mcp与您的实际项目路径。 - 替换
YOUR_USERNAME使用您的操作系统用户名。AE中的桥接面板显示了它使用的路径(例如。 命令路径:.../.after-effects-mcp/ae_command.json).集MCP_AE_BRIDGE_DIR到该目录(不带文件名)。
______________________________________________________________________
运行和使用
- 启动MCP服务器\
您的客户端可以自动启动它,也可以运行: npm start
- 在After Effects中打开桥梁\
窗口 → mcp-bridge-auto.jsx
- 启用自动运行命令 在面板中,AE执行传入的命令
- 使用您的AI客户端\
例子: *创作一首名为《Intro》的作品,1920×1080,30fps,10秒* 或 *“删除名为Test的作文。”*
______________________________________________________________________
项目结构
after-effects-mcp/
├── build/ # Compiled output (after npm run build)
│ ├── index.js # MCP server entry
│ └── scripts/ # ExtendScript (e.g. mcp-bridge-auto.jsx)
├── src/
│ ├── index.ts # Server and tool definitions
│ └── scripts/ # Source for bridge and helpers
├── docs/ # Guides and API reference
├── install-bridge.js # Cross-platform bridge installer
├── install-bridge-mac.sh # macOS installer (sudo for AE 2026)
├── setup.sh / setup.bat # One-command setup
├── start.sh / start.bat # Start server
└── QUICKSTART.md # Short setup and usage guide______________________________________________________________________
脚本
| 命令 | 描述 |
|---|---|
npm run build | 编译TypeScript并复制 src/scripts 到 build/ |
npm run build:win | 与Windows上的构建相同(使用 xcopy) |
npm start | 运行MCP服务器(node build/index.js) |
npm run dev | 构建然后开始 |
npm run install-bridge | 将桥接脚本安装到AE ScriptUI面板(节点脚本)中 |
npm run setup | npm install + npm run build + npm run install-bridge |
______________________________________________________________________
文档
| 文档 | 描述 |
|---|---|
| QUICKSTART.md | 最少的设置和第一个命令 |
| docs/RUN_THIS_VIDEO_PROMPT.md | 复制粘贴提示以在AE中创建视频 (来自AI提示库) |
| docs/MASTER \_产品_指南.md | 端到端视频创建 |
| docs/AI_PROMPT_LIBRARY.md | 即用型提示 |
| 文档/项目_WORKFLOWS.md | 分步工作流程 |
| docs/COMPLETE_food_COVERAGE.md | 完整功能列表 |
| docs/BLENDER_MCP_COMPARISON_AND_ROADMAP.md | 搅拌机MCP比较&还可以添加什么 |
| docs/API_REFERENCE.md文件 | API参考 |
| docs/EFFECT_LIBRARY.md | 效果参考 |
| docs/ARCHITECTURE.md | 系统架构 |
______________________________________________________________________
故障排除
| 问题 | 该怎么办 |
|---|---|
| 安装网桥时“权限被拒绝” | macOS:运行 ./install-bridge-mac.sh (sudo)。Windows:以管理员身份运行终端/CMD,然后 npm run install-bridge. |
| 命令未运行/“找不到命令” | 确保 MCP_AE_BRIDGE_DIR MCP配置中的目录与桥接面板中显示的目录匹配(例如。 ~/.after-effects-mcp).重新启动MCP服务器和AE |
| “允许脚本写入文件和访问网络” | 在中启用它 偏好→ 脚本和表达式,然后重新启动After Effects。 |
| 在AE中找不到面板或脚本 | 重新安装: npm run build 然后 npm run install-bridge (或 ./install-bridge-mac.sh).重新启动AE并检查 窗口 为了 mcp-bridge-auto.jsx. |
| 在Windows上生成失败 | 使用 npm run build:win 而不是 npm run build. |
______________________________________________________________________
贡献
欢迎捐款。打开问题或提交拉取请求。
______________________________________________________________________
学分和许可证
- 原始项目: 达克欣/后遗症mcp
- 由以下人员扩展和维护: Intrazero --122个工具、视频制作工作流程、文档和安装脚本。
根据 MIT许可证.
