After Effects MCP

🎬 After Effects MCP服务器

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

目录

• 特性

- 核心组成特征 - 层管理 - 动画能力

• 安装说明

- 先决条件 - 安装 - 更新MCP配置 - 运行服务器

• 使用指南

- 创作作品 - 使用图层 - 动画

• 可用的MCP工具
• 对于开发者

- 项目结构 - 建设项目 - 贡献

• 许可证

📦 特性

🎥 核心组成特征

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

🧱 层管理

• 创建文本图层 具有可自定义的属性（字体、大小、颜色、位置）
• 创建形状层 （矩形、椭圆形、多边形、星形），带颜色和笔划
• 创建实体/调整图层 背景和效果
• 创建相机图层 具有可配置的缩放和位置
• 创建空对象 用于动画控制
• 修改图层特性 如位置、比例、旋转、不透明度、定时
• 切换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

1. 安装依赖项

   npm install
   # or
   yarn install

1. 构建项目

   npm run build
   # or
   yarn build

1. 安装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

1. 打开后效果

1. 打开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工具

👨‍💻 对于开发者

🧩 项目结构

• 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许可证获得许可-有关详细信息，请参阅许可证文件。