AI导哈

After Effects控制协议服务器

为Adobe After Effects设计的模型上下文协议（MCP）服务器，通过标准化协议使AI助手和其他应用能够控制After Effects。

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

使用说明

🎬 After Effects MCP服务器

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

目录

📦 特性

🎥 核心组成特征

  • 创作作品 具有自定义设置（大小、帧率、持续时间、背景颜色）
  • 列出所有作品 在一个项目中
  • 获取项目信息 例如帧率、尺寸和持续时间

🧱 层管理

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

🌀 动画能力

  • 设置关键帧 用于图层属性（位置、比例、旋转、不透明度等）
  • 应用表达式 为动态动画添加图层属性

⚙️ 安装说明

🛠 先决条件

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

📥 安装

  1. 克隆仓库

    git clone https://github.com/Dakkshin/after-effects-mcp.git
cd after-effects-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安装中。

🔧 更新MCP配置

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

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

▶️ 运行服务器

  1. 启动MCP服务器

    npm start
# or
yarn start

  2. 打开后效果

  3. 打开MCP桥接自动面板

    • 在After Effects中，转到窗口>mcp-bridge-auto.jsx
    • 面板将每隔几秒钟自动检查一次命令
    • 确保“自动运行命令”复选框已启用

🚀 使用指南

在After Effects中运行服务器并打开MCP网桥面板后，您可以通过MCP协议控制After Effects。这允许AI助手或自定义应用程序向After Effects发送命令。

📘 创作作品

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

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

MCP工具使用示例（面向开发人员）：

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

✍️ 使用图层

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

文本图层：

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

形状层：

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

固体层：

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

🕹 动画

您可以通过以下方式设置图层动画：

关键帧：

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

表达：

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

🛠 可用的MCP工具

命令 描述
`create composition` 创建一个新的comp
`run script` 在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

🤝 贡献

欢迎投稿！请随时提交拉取请求。

明星历史

许可证

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

相关 MCP