项目简介

After Effects MCP 集成是一个基于 Model Context Protocol (MCP) 的后端服务，它允许兼容 MCP 的 AI 助手（如 Claude、Cursor 等）直接与 Adobe After Effects (AE) 应用进行交互。通过该集成，AI 可以理解并执行对 AE 项目、合成、图层、效果等的操作，实现智能化的视频编辑和动画创作流程。

主要功能点

• 项目管理: 获取当前 AE 项目信息，列出合成。
• 合成操作: 创建具有自定义尺寸、帧率和时长的合成。
• 图层控制:
  • 添加和修改文字图层，支持字体、颜色、位置、对齐等属性。
  • 创建纯色图层，自定义颜色和尺寸。
  • 创建预设形状（矩形、椭圆、多边形、星形）和自定义形状图层。
  • 修改图层的通用属性，如位置、缩放、旋转、不透明度、3D 属性等。
  • 添加摄像机和灯光图层。
• 效果应用: 浏览效果分类，查看可用效果详情，并向图层应用效果及设置参数。
• 脚本执行: 执行任意 After Effects ExtendScript 代码，实现高级或未直接封装的功能。

安装步骤

1. 克隆仓库: 将项目代码从 GitHub 克隆到本地计算机。

   git clone https://github.com/sunqirui1987/ae-mcp.git
   cd ae-mcp
   

2. 安装 Go/Go+: 确保你的系统安装了 Go 或 Go+ 运行环境。
3. 构建 MCP 服务器程序: 在项目目录下，使用 Go+ 命令构建 MCP 服务器的可执行文件。

   gop build ./cmd/ae-mcp/
   

   这将生成 'ae-mcp' (或 'ae-mcp.exe') 可执行文件。
4. 安装 After Effects 脚本: 将项目中的 'js/ae-mcp.jsx' 脚本安装并运行到 Adobe After Effects 中。通常可以通过 AE 的菜单 'File > Scripts > Run Script File...' 来运行该脚本。请确保 AE 启动并运行了该脚本，它是 AI 与 AE 通信的桥梁。

服务器配置（供 MCP 客户端使用）

要让你的 MCP 客户端（如 Claude Desktop, Cursor 等）连接到 AE-MCP 服务器，你需要在客户端的 MCP 配置中添加服务器信息。配置通常是一个 JSON 格式的文件或设置界面。你需要指定服务器的名称（例如 'aftereffects'）以及启动 AE-MCP 可执行文件的命令路径。

以下是一个配置示例，你需要将 '/path/to/your/ae-mcp.exe' 替换为你在安装步骤 3 中构建的可执行文件的实际路径：

• MCP客户端配置所需信息:
  • 服务器名称 (Server Name): 例如 'aftereffects' (AI 在调用工具时会使用此名称)
  • 启动命令 (Command): AE-MCP 可执行文件的完整路径，例如 '/Users/YourUsername/ae-mcp/ae-mcp' (macOS/Linux) 或 'C:\Projects\ae-mcp\ae-mcp.exe' (Windows)。
  • 命令参数 (Args): 通常为空列表 '[]'。

请查阅你的 MCP 客户端文档，找到其开发者或高级设置中的 MCP 服务器配置选项，并填入上述信息。配置完成后，重启你的 MCP 客户端和 After Effects，并确保 AE 中的 'ae-mcp.jsx' 脚本正在运行。

基本使用方法

配置完成后，你可以在 MCP 客户端中直接使用自然语言向 AI 发出指令，让其控制 After Effects。AI 会通过 MCP 协议调用 AE-MCP 服务器提供的工具。

示例指令:

• "在 After Effects 中创建一个名为 '我的动画' 的新合成，尺寸 1920x1080，时长 15 秒，帧率 24。" (调用 'ae_create_composition' 工具)
• "在 '我的动画' 合成中添加一个文字图层，内容为 '你好，世界！'，字体大小设为 96。" (调用 'ae_add_text_layer' 和 'ae_modify_text_layer' 工具)
• "给这个文字图层应用一个辉光效果。" (调用 'ae_apply_effect' 工具)
• "将文字图层的位置移动到合成中心。" (调用 'ae_modify_layer' 工具)

AI 将会根据你的指令，利用 AE-MCP 服务器提供的工具与 After Effects 进行交互，并在 AE 中创建或修改相应的元素。