After Effects MCP

🚀 Adobe After Effects MCP 服务器

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

🚀 快速开始

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

1. 克隆项目仓库：

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

2. 安装依赖项：

   npm install
   

3. 在 After Effects 中加载脚本文件 src/scripts/mcp-bridge-auto.jsx。

✨ 主要特性

核心合成功能

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

层管理

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

动画功能

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

📦 安装指南

先决条件

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

安装步骤

1. 克隆项目仓库：

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

2. 安装依赖项：

   npm install
   

3. 在 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 文件。