AI导哈

After Effects控制协议服务器

一个用于Adobe After Effects的模型上下文协议（MCP）服务器，通过标准化协议实现AI助手和其他应用程序对After Effects的控制。

  • by Dakkshin
  • JavaScript
  • 本地部署
  • 812 星标
  • 更新于
在 GitHub 查看 Dakkshin/after-effects-mcp

使用说明

🎬 After Effects MCP服务器

✨ Adobe After Effects的模型上下文协议（MCP）服务器，使AI助手和其他应用程序能够通过标准化协议控制After Effects。

目录

📦 特性

🎥 核心组成特征

  • 创作作品 具有自定义设置（大小、帧率、持续时间、背景颜色）
  • 列出所有作品 在一个项目中
  • 获取项目信息 例如帧率、尺寸和持续时间

🧱 层管理

  • 创建文本图层 具有可自定义的属性（字体、大小、颜色、位置）
  • 创建形状层 （矩形、椭圆形、多边形、星形），带颜色和笔划
  • 创建实体/调整图层 背景和效果
  • 创建相机图层 具有可配置的缩放和位置
  • 创建空对象 用于动画控制
  • 修改图层特性 如位置、比例、旋转、不透明度、定时
  • 切换2D/3D模式 对于图层
  • 设置混合模式 （普通、乘法、屏幕等）
  • 轨道遮罩 支撑（阿尔法、亮度、倒置）
  • 重复图层 可选择重命名
  • 删除图层 从组成
  • 创建/修改掩码 具有羽毛状、膨胀性和不透明性

🌀 动画能力

  • 设置关键帧 用于图层属性（位置、比例、旋转、不透明度等）
  • 应用表达式 为动态动画添加图层属性
  • 批次设置属性 同时跨越多层

⚙️ 安装说明

🛠 先决条件

  • 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代码）

存储库包括 .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. 打开后效果

  3. 打开MCP桥接自动面板

    • 在After Effects中，转到窗口>mcp-bridge-auto.jsx
    • 面板将每隔几秒钟自动检查一次命令
    • 确保“自动运行命令”复选框已启用

🚀 使用指南

在After Effects中运行服务器并打开MCP网桥面板后，您可以通过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 设置图层属性（位置、比例、旋转、不透明度、混合模式、三层、trackMatteType、启用等）
batchSetLayerProperties 将特性应用于多个图层
getLayerInfo 获取图层信息（位置、3D状态）
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编译器方法，这种方法可能会在较大的代码库上耗尽内存。

🤝 贡献

欢迎投稿！请随时提交拉取请求。

星迹

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

相关 MCP