After Effects MCP服务

通过Model Context Protocol控制Adobe After Effects,支持从AI助手和应用创建合成、图层、关键帧、效果和完整视频项目。

  • by maghonemi
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 maghonemi/adobe-after-effects-mcp

使用说明

After Effects MCP服务器

从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中使用脚本

  1. 后期特效 (macOS)或 编辑 (Windows)→ 偏好 → 脚本和表达式
  2. 启用 允许脚本写入文件和访问网络
  3. 点击 好的 并在收到提示时重新启动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 到该目录(不带文件名)。

运行和使用

  1. 启动MCP服务器
    您的客户端可以自动启动它,也可以运行: npm start

  2. 在After Effects中打开桥梁
    窗口 → mcp-bridge-auto.jsx

  3. 启用自动运行命令 在面板中,AE执行传入的命令

  4. 使用您的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.

贡献

欢迎捐款。打开问题或提交拉取请求。


学分和许可证

根据 MIT许可证.