AI导哈

AE模型上下文协议服务器

AE-MCP是一个为Adobe After Effects设计的模型上下文协议服务器，提供自动化合成、图层管理、动画效果和渲染工作流的功能。

  • by BhupendraSharma-eng
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 bittu101200/AE-MCP

使用说明

🎬 AE-MCP的后遗症

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

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

该存储库是当前AE-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

  2. 安装依赖项

    npm install
# or
yarn install

  3. 构建项目

    npm run build
# or
yarn build

  4. 安装After Effects面板

    npm run install-bridge
# or
yarn install-bridge

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

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

    • 在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

  2. 打开后效果

  3. 打开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，打开一个问题或提交一个带有重点更改的拉取请求。

相关 MCP