🎬 After Effects MCP Server

基本能力

产品定位

After Effects MCP Server 是一个为 Adobe After Effects 设计的 MCP 服务器，旨在通过标准化协议实现 AI 助手和其他应用程序对 After Effects 的控制。

核心功能

• 核心合成功能：创建自定义设置的合成（大小、帧率、持续时间、背景颜色），列出项目中的所有合成，获取项目信息（帧率、尺寸、持续时间）。
• 图层管理：创建文本图层（可自定义字体、大小、颜色、位置），创建形状图层（矩形、椭圆、多边形、星形）和实色/调整图层，修改图层属性（位置、缩放、旋转、不透明度、时间）。
• 动画能力：为图层属性设置关键帧（位置、缩放、旋转、不透明度等），为图层属性应用表达式以实现动态动画。

适用场景

• AI 助手控制 After Effects 进行自动化视频编辑。
• 开发人员通过 MCP 协议集成 After Effects 到自定义应用程序中。
• 教育场景中用于教学和演示 After Effects 功能。

工具列表

• create-composition：创建新合成。
• run-script：在 AE 内部运行 JS 脚本。
• get-results：获取脚本结果。
• get-help：获取可用命令的帮助。
• setLayerKeyframe：为图层属性添加关键帧。
• setLayerExpression：为属性添加/移除表达式。

常见问题解答

• 确保 Adobe After Effects 2022 或更高版本已安装。
• 确保 Node.js v14 或更高版本已安装。
• 确保 MCP Bridge 面板在 After Effects 中正确安装并启用“自动运行命令”选项。

使用教程

使用依赖

• Adobe After Effects (2022 或更高版本)
• Node.js (v14 或更高版本)
• npm 或 yarn 包管理器

安装教程

1. 克隆仓库 bash git clone https://github.com/yourusername/after-effects-mcp.git cd after-effects-mcp

2. 安装依赖 bash npm install # 或 yarn install

3. 构建项目 bash npm run build # 或 yarn build

4. 安装 After Effects 面板 bash npm run install-bridge # 或 yarn install-bridge

调试方式

1. 启动 MCP 服务器 bash npm start # 或 yarn start

2. 打开 After Effects

3. 打开 MCP Bridge Auto 面板

4. 在 After Effects 中，转到 Window > mcp-bridge-auto.jsx
5. 确保“自动运行命令”复选框已启用

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。