🎬 After Effects MCP Server

🎬 After Effects MCP Server

✨ 一个适用于 Adobe After Effects 的模型上下文协议（MCP）服务，可让 AI 助手和其他应用通过标准化协议控制 After Effects。

目录

• 功能
  • 核心合成功能
  • 图层管理
  • 动画功能
• 设置说明
  • 前置条件
  • 安装
  • 更新 MCP 配置
  • 运行服务
• 使用指南
  • 创建合成
  • 使用图层
  • 动画
• 可用的 MCP 工具
• 开发者指南
  • 项目结构
  • 构建项目
  • 参与贡献
• 许可证

📦 功能

🎥 核心合成功能

• 创建合成，并自定义设置（尺寸、帧率、时长、背景颜色）
• 列出项目中的所有合成
• 获取项目信息，例如帧率、尺寸和时长

🧱 图层管理

• 创建文本图层，并自定义属性（字体、大小、颜色、位置）
• 创建形状图层（矩形、椭圆形、多边形、星形），并设置颜色和描边
• 创建纯色图层/调整图层，用于背景和效果
• 创建摄像机图层，并配置缩放和位置
• 创建空对象，用于动画控制
• 修改图层属性，例如位置、缩放、旋转、不透明度和时间
• 切换图层的 2D/3D 模式
• 设置混合模式（正常、正片叠底、滤色等）
• 支持轨道遮罩（Alpha、亮度、反转）
• 复制图层，并可选择重命名
• 从合成中删除图层
• 创建/修改遮罩，并设置羽化、扩展和不透明度

🌀 动画功能

• 为图层属性设置关键帧（位置、缩放、旋转、不透明度等）
• 为图层属性应用表达式，实现动态动画
• 一次性批量设置多个图层的属性

⚙️ 设置说明

🛠 前置条件

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

📥 安装

1. 克隆仓库

   git clone https://github.com/Dakkshin/after-effects-mcp.git
   cd after-effects-mcp
   

2. 安装依赖项

   npm install
   # or
   yarn install
   

3. 构建项目

   npm run build
   # or
   yarn build
   

4. 安装 After Effects 面板

   npm run install-bridge
   # or
   yarn install-bridge
   

   这会将所需脚本复制到你的 After Effects 安装目录。

🔧 更新 MCP 配置

选项 1：使用 .mcp.json（推荐用于 Claude Code）

仓库中包含 .mcp.json 文件，可用于轻松配置。将其复制到 MCP 设置中，或在设置中引用它：

{
  "mcpServers": {
    "AfterEffectsMCP": {
      "command": "node",
      "args": ["PATH/TO/after-effects-mcp/build/index.js"]
    }
  }
}

选项 2：手动配置

前往你的客户端（例如 Claude 或 Cursor），并更新配置文件：

{
  "mcpServers": {
    "AfterEffectsMCP": {
      "command": "node",
      "args": ["C:\\Users\\Dakkshin\\after-effects-mcp\\build\\index.js"]
    }
  }
}

▶️ 运行服务

1. 启动 MCP 服务

   npm start
   # or
   yarn start
   

2. 打开 After Effects

3. 打开 MCP Bridge Auto 面板

   • 在 After Effects 中，前往 Window > mcp-bridge-auto.jsx
   • 面板每隔几秒会自动检查命令
   • 确保已启用“Auto-run commands”复选框

🚀 使用指南

启动服务并在 After Effects 中打开 MCP Bridge 面板后，即可通过 MCP 协议控制 After Effects。这样，AI 助手或自定义应用程序便可向 After Effects 发送命令。

📘 创建合成

你可以使用自定义设置创建新的合成：

• 名称
• 宽度和高度（以像素为单位）
• 帧速率
• 时长
• 背景颜色

MCP 工具用法示例（面向开发者）：

mcp_aftereffects_create_composition({
  name: "My Composition", 
  width: 1920, 
  height: 1080, 
  frameRate: 30,
  duration: 10
});

✍️ 处理图层

你可以创建和修改不同类型的图层：

文本图层：

• 设置文本内容、字体、大小和颜色
• 在合成中的任意位置放置文本
• 调整时间和不透明度

形状图层：

• 创建矩形、椭圆形、多边形和星形
• 设置填充颜色和描边颜色
• 自定义大小和位置

纯色图层：

• 创建背景颜色
• 创建用于效果的调整图层

🕹 动画

你可以通过以下方式为图层添加动画：

关键帧：

• 在特定时间设置属性值
• 创建运动、缩放、旋转和不透明度变化
• 控制动画的时间安排

表达式：

• 对属性应用 JavaScript 表达式
• 创建动态的程序化动画
• 将属性值相互关联

🛠 可用的 MCP 工具

命令	描述
create-composition	创建新的合成
run-script	在 AE 中运行 JS 脚本
get-results	获取脚本结果
get-help	查看可用命令的帮助
setLayerKeyframe	为图层属性添加关键帧
setLayerExpression	添加或移除属性的表达式
setLayerProperties	设置图层属性（位置、缩放、旋转、不透明度、混合模式、三维图层、轨道遮罩类型、启用状态等）
batchSetLayerProperties	将属性应用于多个图层
getLayerInfo	获取图层信息（位置、三维状态）
createCamera	创建摄像机图层
createNullObject	创建用于动画的空对象
duplicateLayer	复制图层
deleteLayer	删除图层
setLayerMask	创建或修改图层遮罩

👨‍💻 面向开发者

🧩 项目结构

• src/index.ts：MCP 服务实现
• src/scripts/mcp-bridge-auto.jsx：After Effects 主面板脚本
• install-bridge.js：在 After Effects 中安装面板的脚本

📦 构建项目

npm run build
# or
yarn build

注意： 本项目使用 esbuild 加快构建速度，取代了之前的 TypeScript 编译器方案；该方案在较大的代码库上可能会耗尽内存。

🤝 参与贡献

欢迎贡献！欢迎提交 Pull Request。

Star 历史

许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。