SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI开发平台after-effects-mcp

after-effects-mcp

after-effects-mcp 是一个 MCP 服务器，用于让 AI 客户端（如 Claude Code、Claude Desktop）通过自然语言控制 Adobe After Effects。它支持执行 ExtendScript、后台渲染、深入检查合成与图层，并提供阿拉伯语/从右到左（RTL）及多语言支持。该增强版基于 Dakkshin/after-effects-mcp 构建，共包含 57 个工具，可在任意 UI 语言的 After Effects 上工作。

访问官网

工具介绍

用途

after-effects-mcp 是一个 MCP（Model Context Protocol）服务器，用于从任意 MCP 客户端（如 Claude Code、Claude Desktop）通过自然语言控制 Adobe After Effects。它可以创建和检查合成与图层、制作动画、应用效果与预设、管理蒙版/摄像机、在后台渲染，并运行任意 ExtendScript，同时提供阿拉伯语/RTL 优先支持，且工具可在任意 UI 语言的 After Effects 上工作。

该版本是增强版，基于 Dakkshin/after-effects-mcp 的原始工作构建，详见 CREDITS.md。

主要能力

  • 共 57 个工具（官方文本中另有“47 tools”的表述，以仓库实际为准）。
  • 检查与诊断：see-frame、contact-sheet、match-reference、inspect-comp、inspect-layer、get-results、check-bridge、run-bridge-test、get-help。
  • 合成与图层：create-composition、set-composition-properties、create-text-layer、localize-comp、create-camera、create-adjustment-layer、duplicate-layer、delete-layer、center-layers、set-layer-mask、batch-set-layer-properties、set-layer-parent、reorder-layer、precompose-layers、populate-template。
  • 动画：setLayerKeyframe、setLayerExpression、get-layer-clip-frames、animate-to-audio、animate-from-data。
  • 效果：apply-effect、add-any-effect、apply-effect-template、list-layer-effects、list-available-effects、set-effect-property、set-effect-keyframe、remove-effect、mcp_aftereffects_get_effects_help。
  • 预设：list-presets、search-presets、apply-preset。
  • 音频与标记：get-audio-info、set-audio-levels、analyze-audio-waveform、add-marker、add-markers-bulk。
  • 项目素材：import-footage、list-project-items、relink-footage。
  • 渲染：add-to-render-queue、render-queue、start-render、render-aerender、render-status。
  • 高级：execute-script（任意 ExtendScript）、run-script、test-animation。
  • 项目/合成概览也可使用 run-script 配合 getProjectInfo / listCompositions。

完整参考见 docs/TOOLS.md（全部 57 个工具）与 docs/ARCHITECTURE.md（桥接工作原理）。

使用方式

前置条件

  • Adobe After Effects 2022 或更高版本。
  • Windows 或 macOS。After Effects 本身仅在这两个平台运行，因此服务器应与 After Effects 运行在同一台机器上。Node 进程可在 Linux 上启动，CI 也在 Linux 上构建和测试，但没有可供其驱动的 After Effects。
  • Node.js 18+（https://nodejs.org）。
  • 一个 MCP 客户端（例如 Claude Code：npm install -g @anthropic-ai/claude-code）。

在 After Effects 中

  1. 启用脚本：Windows 为 Edit > Preferences > Scripting & Expressions；macOS 为 After Effects > Settings > Scripting & Expressions，启用“Allow Scripts to Write Files and Access Network”。
  2. 重启 After Effects。
  3. Window > mcp-bridge-auto.jsx，保持该面板打开。

注册服务器

将服务器注册到你的 MCP 客户端。

首次测试

让客户端“check the After Effects bridge”。它应报告 bridgeVersion: 1.13.0-mcp-enhanced 和 versionMatch: true。

修改后

如果编辑了服务器，重新运行 npm run build，然后重启 MCP 客户端。如果编辑了桥接，还需重新运行 npm run install-bridge 并重启 After Effects。

适用场景

  • 通过自然语言在 After Effects 中创建、检查和修改合成与图层。
  • 制作动画、应用效果与预设、管理蒙版与摄像机。
  • 后台渲染与渲染队列管理。
  • 运行任意 ExtendScript 实现自定义自动化。
  • 阿拉伯语/RTL 及多语言文本处理。

限制

  • 需要 Adobe After Effects 2022 或更高版本，且仅支持 Windows 或 macOS；服务器需与 After Effects 运行在同一台机器上。
  • 需要 Node.js 18+ 和一个 MCP 客户端。
  • 需在 After Effects 中启用脚本写入文件与访问网络的权限，并保持 mcp-bridge-auto.jsx 面板打开。
  • 阿拉伯语完整字形塑造需在 After Effects 中启用 Middle-Eastern 文本引擎（Windows：Preferences > Type；macOS：Settings > Type），并使用支持阿拉伯语的字体（如 Tahoma、Cairo）。
  • 若出现超时或异常，先检查 After Effects 桥接；版本不匹配时重新运行 npm run install-bridge 并重启 After Effects；结果文件过期通常因面板未运行或无法写入文件。
  • Windows + OneDrive 环境下共享文件夹为 %LOCALAPPDATA%\ae-mcp-bridge（防 OneDrive 干扰），可用 AE_MCP_BRIDGE_DIR 环境变量覆盖两端。
  • 纯逻辑位于 src/lib/bridge-core.ts，单元测试在 tests/bridge-core.test.ts。CI 在 Linux、macOS、Windows 上对 Node 18、20、22 进行类型检查和构建，并在 Node 20 和 22 上运行测试套件（Vitest 4 需要 Node 20+）。

许可

MIT License。原始工作 © 2025 Dakkshin；增强多语言版 © 2026 Abdelrahman Youssef。详见 LICENSE 与 CREDITS.md。

同类工具

查看分类