返回 MCP 目录
public公开dns本地运行

after-effects-mcp

一个为Adobe After Effects设计的模型上下文协议(MCP)服务器,通过标准化协议实现AI助手等应用对After Effects的控制。

article

README

🚀 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 文件。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端