🎬 After Effects MCP服务器
✨ Adobe After Effects的模型上下文协议（MCP）服务器，使AI助手和其他应用程序能够通过标准化协议控制After Effects。
目录
📦 特性
🎥 核心组成特征
- 创作作品 具有自定义设置（大小、帧率、持续时间、背景颜色）
- 列出所有作品 在一个项目中
- 获取项目信息 例如帧率、尺寸和持续时间
🧱 层管理
- 创建文本图层 具有可自定义的属性（字体、大小、颜色、位置）
- 创建形状层 （矩形、椭圆形、多边形、星形），带颜色和笔划
- 创建实体/调整图层 背景和效果
- 创建相机图层 具有可配置的缩放和位置
- 创建空对象 用于动画控制
- 修改图层特性 如位置、比例、旋转、不透明度、定时
- 切换2D/3D模式 对于图层
- 设置混合模式 （普通、乘法、屏幕等）
- 轨道遮罩 支撑（阿尔法、亮度、倒置）
- 重复图层 可选择重命名
- 删除图层 从组成
- 创建/修改掩码 具有羽毛状、膨胀性和不透明性
🌀 动画能力
- 设置关键帧 用于图层属性（位置、比例、旋转、不透明度等）
- 应用表达式 为动态动画添加图层属性
- 批次设置属性 同时跨越多层
⚙️ 安装说明
🛠 先决条件
- 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
# or
yarn install- 构建项目
npm run build
# or
yarn build- 安装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"]
}
}
}▶️ 运行服务器
- 启动MCP服务器
npm start
# or
yarn start- 打开后效果
- 打开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许可证获得许可-有关详细信息，请参阅许可证文件。