mcp 后效应

🎬 After Effects MCP 服务器

✨ Adobe After Effects 的模型上下文协议 (MCP) 服务器，使 AI 助手和其他应用程序能够通过标准化协议控制 After Effects。

📦 功能

🎥 核心 Composition 功能

使用自定义设置（大小、帧速率、持续时间、背景颜色）创建作品
列出项目中的所有合成
**获取项目信息，**例如帧速率、尺寸和持续时间

🧱 图层管理

创建具有可自定义属性（字体、大小、颜色、位置）的文本层
使用颜色和描边创建形状图层（矩形、椭圆形、多边形、星形）
为背景和效果创建实体/调整图层
**修改图层属性，**如位置、比例、旋转、不透明度和时间

🌀 动画功能

设置图层属性的关键帧（位置、比例、旋转、不透明度等）
将表达式应用于图层属性以实现动态动画

⚙️ 设置说明

🛠 先决条件

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

📥 安装

克隆存储库
git clone https://github.com/yourusername/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 配置

转到您的客户端（例如 Claude 或 Cursor ）并更新您的配置文件

{
  "mcpServers": {
    "AfterEffectsMCP": {
      "command": "node",
      "args": ["C:\\Users\\Dakkshin\\after-effects-mcp\\build\\index.js"]
    }
  }
}

▶️ 运行服务器

启动 MCP 服务器
npm start # or yarn start
打开 After Effects
打开 MCP Bridge Auto 面板
- 在 After Effects 中，转到窗口 > 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 工具

命令	描述
`创建组合`	创建新的伴奏
`运行脚本`	在 AE 中运行 JS 脚本
`获取结果`	获取脚本结果
`获取帮助`	可用命令的帮助
`setLayerKeyframe`	将关键帧添加到图层属性
`setLayerExpression`	从属性中添加/删除表达式

👨‍💻对于开发人员

🧩 项目结构

src/index.ts ：MCP 服务器实现
src/scripts/mcp-bridge-auto.jsx : 主 After Effects 面板脚本
install-bridge.js ：在 After Effects 中安装面板的脚本

📦构建项目

npm run build
# or
yarn build

🤝 贡献

欢迎贡献代码！欢迎提交 Pull 请求。

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

mcp-after-effects

Integrations