Token导航 LogoToken导航TokenDH.com
Adobe After Effects MCP logo
AI代理未说明官方级别未说明来源级核验

Adobe After Effects MCP

MCP Server

通过Model Context Protocol控制Adobe After Effects,支持从AI助手和应用创建合成、图层、关键帧、效果和完整视频项目。

工具数

12

提示词数

0

GitHub Stars

0

资源数

0
自动化控制JavaScriptClaudeClaude DesktopClaudeCursor

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

作者 / 组织

maghonemi

提供方

maghonemi

最后核验

2026/5/17 20:22

快速接入

先看主来源和安装命令,再打开仓库或文档;下面只保留这个条目的关键接入事实。

详细介绍

After Effects MCP服务器

](https://nodejs.org) ![TypeScript](https://www.typescriptlang.org/) ![License](LICENSE) ![MCP](https://modelcontextprotocol.io/)

从AI助手和应用程序控制Adobe After Effects 通过 模型上下文协议通过自然语言或任何MCP客户端创建构图、图层、关键帧、效果和完整视频项目。

______________________________________________________________________

目录

______________________________________________________________________

特性

122工具 · 5资源 · 8个提示

区域能力
项目创建、打开、保存;设置(位深度、颜色空间);删除/重命名项目;删除未使用的镜头;收集文件
作品创建、复制、, 按名称或索引删除,重命名;工作区;选定层;运动模糊、3D、帧混合
图层文本、形状、实体、调整、零点、相机、灯光、音频;复制、删除、重命名、移动、拆分、父级、预压缩
变换位置、比例、旋转(2D/3D);中心/适合比赛;材料选择;混合模式;轨道床垫
动画关键帧;放宽预设;运动路径;淡入淡出/滑动/缩放/旋转/模糊预设;交错;表达式模板
效果按匹配名称申请;模板(发光、模糊、颜色等);预设;动画效果属性
口罩矩形、椭圆形、路径;羽毛,不透明,膨胀;遮罩显示动画
形状路径、修改器(修剪、重复、摆动等);变形
渲染添加到队列;开始渲染;导出H.264、ProRes;单帧
导入导入文件;替换镜头;解读;重载;缺失镜头列表
场景和渲染获取场景摘要、获取渲染进度、获取图层树、设置项目、列出可用字体、获取/设置关键帧插值
视口/视野获取视口屏幕截图 –将当前comp捕获为PNG,以便AI可以“看到”场景(如 搅拌机MCP 视口截图)

docs/COMPLETE_food_COVERAGE.mddocs/BLENDER_MCP_COMPARISON_AND_ROADMAP.md 全面覆盖。

______________________________________________________________________

先决条件

  • Adobe After Effects 2022年或以后
  • Node.js 18岁或以后
  • npm (或纱线)

______________________________________________________________________

快速启动

git clone https://github.com/Dakkshin/after-effects-mcp.git
cd after-effects-mcp
npm install
npm run build

然后将桥接器安装到After Effects中(参见 安装),配置MCP客户端 MCP_AE_BRIDGE_DIR,打开 mcp-bridge-auto.jsx AE中的面板,启用 自动运行命令,并开始从您的AI客户端发送命令。

______________________________________________________________________

安装

1.克隆和构建

git clone https://github.com/Dakkshin/after-effects-mcp.git
cd after-effects-mcp
npm install
npm run build

窗户: 如果 npm run build 复制、使用失败 npm run build:win 相反。

2.安装After Effects桥

MCP服务器通过以下方式与After Effects通信 桥牌脚本 必须位于AE的ScriptUI Panels文件夹中。

平台命令注释
macOS./install-bridge-mac.sh用途 sudo;安装到AE 2026中。系统将提示您输入密码。
视窗npm run install-bridge复制到第一个检测到的AE版本。如果遇到权限错误,请以管理员身份运行。
macOS(无sudo)npm run install-bridge尝试在没有sudo的情况下进行复制;如果失败,请使用 install-bridge-mac.sh.

代码更改后重新安装:npm run build,然后再次运行安装步骤(例如。 npm run install-bridge./install-bridge-mac.sh).

3.允许在After Effects中使用脚本

  1. 后期特效 (macOS)或 编辑 (Windows)→ 偏好脚本和表达式
  2. 启用 允许脚本写入文件和访问网络
  3. 点击 好的 并在收到提示时重新启动After Effects

没有这个,网桥将无法读取/写入命令文件。

4.一个命令设置(可选)

  • macOS/Linux: ./setup.sh --安装deps、构建并运行网桥安装程序
  • 窗户: setup.bat --同样的想法

______________________________________________________________________

MCP客户端配置

将服务器添加到MCP配置中(例如Cursor、Claude Desktop)。使用 绝对路径build/index.js 并设置 网桥目录 因此服务器和After Effects使用相同的文件夹。

示例(光标 mcp.json 或设置):

{
  "mcpServers": {
    "AfterEffectsMCP": {
      "command": "node",
      "args": ["/absolute/path/to/after-effects-mcp/build/index.js"],
      "env": {
        "MCP_AE_BRIDGE_DIR": "/Users/YOUR_USERNAME/.after-effects-mcp"
      }
    }
  }
}
  • 替换 /absolute/path/to/after-effects-mcp 与您的实际项目路径。
  • 替换 YOUR_USERNAME 使用您的操作系统用户名。AE中的桥接面板显示了它使用的路径(例如。 命令路径: .../.after-effects-mcp/ae_command.json).集 MCP_AE_BRIDGE_DIR 到该目录(不带文件名)。

______________________________________________________________________

运行和使用

  1. 启动MCP服务器\

您的客户端可以自动启动它,也可以运行: npm start

  1. 在After Effects中打开桥梁\

窗口mcp-bridge-auto.jsx

  1. 启用自动运行命令 在面板中,AE执行传入的命令
  1. 使用您的AI客户端\

例子: *创作一首名为《Intro》的作品,1920×1080,30fps,10秒* 或 *“删除名为Test的作文。”*

______________________________________________________________________

项目结构

after-effects-mcp/
├── build/                 # Compiled output (after npm run build)
│   ├── index.js           # MCP server entry
│   └── scripts/           # ExtendScript (e.g. mcp-bridge-auto.jsx)
├── src/
│   ├── index.ts           # Server and tool definitions
│   └── scripts/           # Source for bridge and helpers
├── docs/                  # Guides and API reference
├── install-bridge.js      # Cross-platform bridge installer
├── install-bridge-mac.sh  # macOS installer (sudo for AE 2026)
├── setup.sh / setup.bat   # One-command setup
├── start.sh / start.bat   # Start server
└── QUICKSTART.md          # Short setup and usage guide

______________________________________________________________________

脚本

命令描述
npm run build编译TypeScript并复制 src/scriptsbuild/
npm run build:win与Windows上的构建相同(使用 xcopy)
npm start运行MCP服务器(node build/index.js)
npm run dev构建然后开始
npm run install-bridge将桥接脚本安装到AE ScriptUI面板(节点脚本)中
npm run setupnpm install + npm run build + npm run install-bridge

______________________________________________________________________

文档

文档描述
QUICKSTART.md最少的设置和第一个命令
docs/RUN_THIS_VIDEO_PROMPT.md复制粘贴提示以在AE中创建视频 (来自AI提示库)
docs/MASTER \_产品_指南.md端到端视频创建
docs/AI_PROMPT_LIBRARY.md即用型提示
文档/项目_WORKFLOWS.md分步工作流程
docs/COMPLETE_food_COVERAGE.md完整功能列表
docs/BLENDER_MCP_COMPARISON_AND_ROADMAP.md搅拌机MCP比较&还可以添加什么
docs/API_REFERENCE.md文件API参考
docs/EFFECT_LIBRARY.md效果参考
docs/ARCHITECTURE.md系统架构

______________________________________________________________________

故障排除

问题该怎么办
安装网桥时“权限被拒绝”macOS:运行 ./install-bridge-mac.sh (sudo)。Windows:以管理员身份运行终端/CMD,然后 npm run install-bridge.
命令未运行/“找不到命令”确保 MCP_AE_BRIDGE_DIR MCP配置中的目录与桥接面板中显示的目录匹配(例如。 ~/.after-effects-mcp).重新启动MCP服务器和AE
“允许脚本写入文件和访问网络”在中启用它 偏好→ 脚本和表达式,然后重新启动After Effects。
在AE中找不到面板或脚本重新安装: npm run build 然后 npm run install-bridge (或 ./install-bridge-mac.sh).重新启动AE并检查 窗口 为了 mcp-bridge-auto.jsx.
在Windows上生成失败使用 npm run build:win 而不是 npm run build.

______________________________________________________________________

贡献

欢迎捐款。打开问题或提交拉取请求。

______________________________________________________________________

学分和许可证

根据 MIT许可证.

目录标签

目录标签

自动化控制JavaScriptClaude视频编辑本地部署AI集成AdobeAfterEffectsMCP协议

支持客户端

Claude DesktopClaudeCursor

接入字段

传输方式(transport,传输协议)

未说明

鉴权方式(authType,认证方式)

none

工具数量(toolCount,工具数)

12

资源数量(resourceCount,资源数)

0

提示词数量(promptCount,提示词数)

0

权限和风险

未说明none部署方式未说明

接入前请确认传输方式、认证方式和部署位置,并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限;先核对安装命令和配置内容。

仍需确认:installCommand

来源信息

继续浏览同类 MCP