后期效果-MCP

Name: 后期效果-MCP
Author: Dakkshin

作者：Dakkshin140 星标更新：2025-10-16

安装使用来源：spider==github.com

项目介绍

🎬 After Effects MCP Server

License

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

📦 功能

🎥 核心合成功能

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

🧱 图层管理

创建具有可定制属性（字体、大小、颜色、位置）的文本图层
创建形状图层（矩形、椭圆、多边形、星形），并设置颜色和描边
创建实色/调整图层作为背景和效果
修改图层属性，如位置、缩放、旋转、不透明度和时间

🌀 动画能力

为图层属性（位置、缩放、旋转、不透明度等）设置关键帧
应用表达式到图层属性以实现动态动画

⚙️ 设置说明

🛠 先决条件

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

📥 安装

克隆仓库

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

安装依赖
```
npm install
# 或
yarn install
```
构建项目
```
npm run build
# 或
yarn build
```
安装After Effects面板
```
npm run install-bridge
# 或
yarn install-bridge
```
这将把必要的脚本复制到您的After Effects安装中。

🔧 更新MCP配置

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

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

▶️ 运行服务器

启动MCP服务器
```
npm start
# 或
yarn start
```
打开After Effects
打开MCP Bridge Auto面板
- 在After Effects中，转到窗口 > mcp-bridge-auto.jsx
- 面板会每隔几秒自动检查命令
- 确保“自动运行命令”复选框已启用

🚀 使用指南

一旦您启动了服务器并在After Effects中打开了MCP Bridge面板，就可以通过MCP协议控制After Effects。这允许AI助手或自定义应用程序向After Effects发送命令。

📘 创建合成

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

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

示例MCP工具用法（供开发者参考）：

mcp_aftereffects_create_composition({
  name: "我的合成", 
  width: 1920, 
  height: 1080, 
  frameRate: 30,
  duration: 10
});

✍️ 处理图层

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

文本图层：

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

形状图层：

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

实色图层：

创建背景颜色
创建调整图层以添加效果

🕹 动画

您可以对图层进行动画处理：

关键帧：

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

表达式：

将JavaScript表达式应用于属性
创建动态、过程性动画
将属性值相互连接

🛠 可用的MCP工具

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

👨‍💻 开发者指南

🧩 项目结构

src/index.ts: MCP服务器实现
src/scripts/mcp-bridge-auto.jsx: 主要的After Effects面板脚本
install-bridge.js: 安装面板到After Effects的脚本

📦 构建项目

npm run build
# 或
yarn build