JinDaGe - after-effects-mcp MCP Details

article

README

🚀 Adobe After Effects MCP 服务器

🎬 Adobe After Effects MCP 服务器是一个强大的工具，可用于创建、管理合成，操作层以及实现动画效果。它基于 Node.js 运行，与 Adobe After Effects 软件深度集成，为用户提供便捷的创作体验。

🚀 快速开始

本项目需要 Node.js（版本 14 或更高）和 Adobe After Effects 软件。请按照以下步骤完成安装：

克隆项目仓库：

git clone https://github.com/your-repository.git

安装依赖项：
```
npm install
```
在 After Effects 中加载脚本文件 src/scripts/mcp-bridge-auto.jsx。

✨ 主要特性

核心合成功能

能够创建和管理新的合成，还可灵活设置合成的分辨率、帧率和时长。

层管理

支持创建和操作不同类型的层，如文本、形状、固态层，并且可以调整层的位置、缩放、旋转和不透明度。

动画功能

可添加关键帧以精准控制属性变化，还能应用 JavaScript 表达式实现动态动画效果。

📦 安装指南

先决条件

Node.js（版本 14 或更高）。
Adobe After Effects 软件。

安装步骤

克隆项目仓库：

git clone https://github.com/your-repository.git

安装依赖项：
```
npm install
```
在 After Effects 中加载脚本文件 src/scripts/mcp-bridge-auto.jsx。

💻 使用示例

基础用法

创建合成

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

操作层

文本层

创建文本并设置属性：

setLayerText("myLayer", "Hello World!", { fontSize: 24, color: "#ff0000" });

调整位置和动画：

moveLayerToPosition("myLayer", { x: 500, y: 300 }, 1);

形状层

创建矩形并设置属性：

createShapeLayer("rectangle", {
  position: [100, 100],
  size: [200, 100],
  fillColor: "#00ff00"
});

固态层

创建背景颜色层：

createSolidLayer("bg", { position: [0, 0], size: [1920, 1080], fillColor: "#ffffff" });

动画

关键帧

添加位置动画：

setLayerKeyframe("myLayer", "position", [
  { time: 0, value: [100, 100] },
  { time: 2, value: [500, 300] }
]);

表达式

应用位置偏移表达式：

setLayerExpression("myLayer", "positionOffset", "time * 10");

📚 详细文档

开发者信息

项目结构

src/index.ts：MCP 服务器实现。
src/scripts/mcp-bridge-auto.jsx：主 After Effects 脚本文件。

构建项目

npm run build

贡献指南

欢迎提交 Pull Request！请确保代码符合规范并包含详细的注释。

📄 许可证

本项目使用 MIT License。详细信息请参阅 LICENSE 文件。

after-effects-mcp