AE MCP

🎬 AE-MCP的后遗症

✨ AE-MCP是Adobe After Effects的模型上下文协议（MCP）服务器，它为AI助手和自定义工具提供了一种可靠的方法来自动化构图、图层、动画、效果、渲染和项目工作流程。

由Bhupendra Sharma创建、维护并积极扩展。

该存储库是当前AE-MCP实施的主要场所，包括桥接工作流程、自动化界面、工具和正在进行的产品改进。

目录

• 特性

- 组成与项目 - 层管理 - 动画和属性 - 效果和渲染 - 生产力

• 安装说明

- 先决条件 - 安装 - 更新MCP配置 - 运行服务器

• 使用指南

- 创作作品 - 使用图层 - 动画

• 可用的MCP工具
• 对于开发者

- 项目结构 - 建设项目 - 测试 - 冒烟测试 - 贡献

📦 特性

🎥 组成与项目

• 创建并列出作品
• 检查构图设置（分辨率、帧率、持续时间、工作区域）
• 打开/保存项目并检查项目项

🧱 层管理

• 创建文本、形状、实体、空和调整层
• 重新排序、重命名、删除、父级和切换可见性
• 混合模式、轨迹蒙版、蒙版和图层复制

🌀 动画和属性

• 使用缓动设置关键帧
• 添加/删除表达式
• 通过规范属性路径读取/写入属性值
• 检查属性树和元数据

🎨 效果和渲染

• 按显示名称或匹配名称应用效果
• 读取/修改/删除效果属性
• 排队和渲染构图，捕捉帧

🧰 生产力

• 单个撤消步骤中的批处理操作
• 按内容搜索文本层
• 标记、运动模糊、帧混合、时间重映射

⚙️ 安装说明

🛠 先决条件

• Adobe After Effects（2022或更高版本）
• Node.js（推荐18+；测试使用 node --test)
• npm或yarn包管理器

📥 安装

1. 克隆仓库

   git clone https://github.com/bittu101200/AE-MCP.git
   cd AE-MCP

1. 安装依赖项

   npm install
   # or
   yarn install

1. 构建项目

   npm run build
   # or
   yarn build

1. 安装After Effects面板

   npm run install-bridge
   # or
   yarn install-bridge

这将把必要的脚本复制到After Effects安装中。

1. 允许脚本访问文件/网络

- 在After Effects中，启用：首选项→ 脚本和表达式→ “允许脚本写入文件和访问网络”

🔧 更新MCP配置

将MCP客户端指向内置服务器条目(build/index.js):

Mac/Linux：

{
  "mcpServers": {
    "AfterEffectsMCP": {
      "command": "node",
      "args": ["/path/to/AE-MCP/build/index.js"]
    }
  }
}

窗户：

{
  "mcpServers": {
    "AfterEffectsMCP": {
      "command": "node",
      "args": ["C:\\\\path\\\\to\\\\AE-MCP\\\\build\\\\index.js"]
      }
    }
  }

👤 作者与署名

• AE-MCP的主要作者和维护者：Bhupendra Sharma
• 该存储库反映了MCP服务器、桥接工作流、文档、测试和自动化功能中的大量原创工作
• 鸣谢 Dakkshin/after-effects-mcp 对于有助于激发该项目方向的原始基础理念和早期基础

▶️ 运行服务器

1. 启动MCP服务器

   npm start
   # or
   yarn start

1. 打开后效果

1. 打开MCP桥接自动面板

- 在After Effects中，转到窗口>mcp-bridge-auto.jsx - 面板将每隔几秒钟自动检查一次命令 - 确保“自动运行命令”复选框已启用 - 网桥从以下位置读取命令/结果 ~/Documents/ae-mcp-bridge

🚀 使用指南

一旦服务器运行并且MCP Bridge面板在After Effects中打开，AI助手和自定义应用程序就可以将结构化命令直接发送到您的After Effects工作流中。

📘 创作作品

您可以使用自定义设置创建新组合，例如：

• 名字
• 宽度和高度（像素）
• 帧率
• 持续时间
• 背景颜色

MCP工具使用示例：

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

✍️ 使用图层

您可以创建和修改不同类型的图层：

文本图层：

• 设置文本内容、字体、大小和颜色
• 将文本放置在作文中的任何位置
• 调整定时和不透明度

形状层：

• 创建矩形、椭圆、多边形和星形
• 设置填充和笔划颜色
• 自定义大小和位置

固体层：

• 创建背景颜色
• 为效果制作调整层

🕹 动画

您可以通过以下方式自动化动画工作流程：

关键帧：

• 在特定时间设置属性值
• 创建运动、缩放、旋转和不透明度更改
• 控制动画的播放时间

表达：

• 将JavaScript表达式应用于属性
• 创建动态程序动画
• 将属性值相互连接

🛠 可用的MCP工具

公共命名约定是 烤肉串箱 （推荐）。旧的camelCase名称仍然可用，以实现向后兼容性。

核心

• create-composition, list-compositions （资源）
• run-script, run-bridge-test
• get-results, bridge-health, get-help
• execute-batch

层管理

• move-layer, rename-layer, set-layer-visibility, delete-layer
• create-null-object, create-adjustment-layer, duplicate-layer
• set-blending-mode, set-layer-parent, add-mask, set-track-matte

动画和属性

• set-layer-keyframe, get-keyframes, remove-keyframe
• set-layer-expression, get-expression
• getLayerInfo （增强层检查；仅适用于camelCase）
• inspect-property-tree, get-property-metadata, get-property-value, set-property-value

效果

• apply-effect, apply-effect-template, get-effects-help
• get-layer-effects, get-effect-properties, set-effect-property, remove-effect

项目与资产

• list-project-items, get-project-item-info, get-composition-settings
• import-file, import-from-url, add-layer-from-item, precompose-layers
• open-project, save-project, get-active-comp

渲染和输出

• add-to-render-queue, start-render, render-composition, capture-frame

文本、搜索、标记、QoL

• set-text-properties, get-text-properties, search-text-layers
• add-marker, get-markers, remove-marker
• set-time-remapping, set-motion-blur, set-frame-blending

笔记：

• 特性工具使用规范特性路径和规范化封套。
• 更新后 mcp-bridge-auto.jsx，在测试更改之前重新安装/重新打开面板。

👨‍💻 对于开发者

🧩 项目结构

• src/index.ts：MCP服务器实现
• src/bridge/*：网桥有效载荷规范化和模式
• src/contracts/*：财产路径规范化和响应合同
• src/scripts/mcp-bridge-auto.jsx：主After Effects面板脚本
• install-bridge.js：在After Effects中安装面板的脚本

📦 建设项目

npm run build
# or
yarn build

✅ 测试

npm test

🔍 冒烟测试

node test-tools.js

🤝 贡献

欢迎捐款。如果你想改进AE-MCP，打开一个问题或提交一个带有重点更改的拉取请求。