Adobe After Effects MCP

After Effects MCP服务器

从AI助手和应用程序控制Adobe After Effects 通过 模型上下文协议通过自然语言或任何MCP客户端创建构图、图层、关键帧、效果和完整视频项目。

______________________________________________________________________

目录

• 特性
• 先决条件
• 快速启动
• 安装
• MCP客户端配置
• 运行和使用
• 项目结构
• 脚本
• 文档
• 故障排除
• 贡献
• 学分和许可证

______________________________________________________________________

特性

122工具 · 5资源 · 8个提示

看 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文件夹中。

代码更改后重新安装： 跑 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

1. 在After Effects中打开桥梁\

窗口 → mcp-bridge-auto.jsx

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

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

______________________________________________________________________

脚本

______________________________________________________________________

文档

______________________________________________________________________

故障排除

______________________________________________________________________

贡献

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

______________________________________________________________________

学分和许可证

• 原始项目： 达克欣/后遗症mcp
• 由以下人员扩展和维护： Intrazero --122个工具、视频制作工作流程、文档和安装脚本。

根据 MIT许可证.