🎬 After Effects MCP 服务器

✨ 一个用于 Adobe After Effects 的 Model Context Protocol (MCP) 服务器，使 AI 助手和其他应用程序能够通过标准化协议控制 After Effects。

目录

• 特性
  • 核心合成特性
  • 图层管理
  • 动画功能
• 设置说明
  • 先决条件
  • 安装
  • 更新 MCP 配置
  • 运行服务器
• 使用指南
  • 创建合成
  • 处理图层
  • 动画
• 可用的 MCP 工具
• 开发者指南
  • 项目结构
  • 构建项目
  • 贡献
• 许可证

📦 特性

🎥 核心合成特性

• 创建合成：自定义设置（大小、帧率、持续时间、背景颜色）
• 列出所有合成：在项目中
• 获取项目信息：如帧率、尺寸和持续时间

🧱 图层管理

• 创建文本图层：可自定义属性（字体、大小、颜色、位置）
• 创建形状图层：（矩形、椭圆、多边形、星形）带颜色和描边
• 创建纯色/调整图层：用于背景和效果
• 修改图层属性：如位置、缩放、旋转、不透明度和时间

🌀 动画功能

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

⚙️ 设置说明

🛠 先决条件

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

📥 安装

1. 克隆仓库

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

2. 安装依赖项

   npm install
   # 或
   yarn install
   

3. 构建项目

   npm run build
   # 或
   yarn build
   

4. 安装 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"]
    }
  }
}

▶️ 运行服务器

1. 启动 MCP 服务器

   npm start
   # 或者
   yarn start
   

2. 打开 After Effects

3. 打开 MCP Bridge Auto 面板

   • 在 After Effects 中，进入 Window > mcp-bridge-auto.jsx
   • 该面板将每隔几秒钟自动检查命令
   • 确保“自动运行命令”复选框已启用

🚀 使用指南

一旦你启动了服务器并在 After Effects 中打开了 MCP Bridge 面板，你就可以通过 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

🤝 贡献

欢迎贡献！请随时提交 Pull Request。

许可证

该项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。