ae-mcp

English | 简体中文

一行设置提示词 — 将以下内容粘贴到 Claude Code 或其他 AI 代理中：

Install the ae-mcp ZXP and the native plug-in for my platform from the v0.10.3
release, open Window > Extensions
> ae-mcp in After Effects, then connect Claude Code with `claude mcp add
--transport http ae http://127.0.0.1:11488/mcp`; for Claude Desktop, configure
the extension's `host/stdio-shim.js` with the system Node executable and ask me
to start a new client session before testing `ae_status`.

ae-mcp 通过本地 MCP 端点将 After Effects CEP 面板连接到 AI 客户端。面板在 http://127.0.0.1:11488/mcp 上托管服务；宿主是一个使用 Express 的 Node 进程，After Effects 状态通过 ExtendScript 和冻结的原生 AEGP 平面来访问。

安装并首次运行

1. 在 After Effects 中安装已签名的 ZXP。

2. 将匹配的原生插件安装到为宿主选定的 After Effects 插件目录中 — Windows 上为 .aex，macOS 上为 AeMcpNative.plugin 包。请确保该版本对来自同一发布版本。ZXP 不包含平台二进制文件，可在两个系统上安装；只有这个原生插件是按平台构建的，而 ae_nativeExec 是唯一需要它的工具。Install 中列出了各平台的确切目标位置；此外，macOS 包还需要清除其下载隔离属性，After Effects 才会加载它。

3. 启动 After Effects，然后打开 窗口 > 扩展 > ae-mcp。外部客户端使用 MCP 时，请保持面板打开。

4. 从下方两种受支持的外部连接方式中选择一种进行配置。

面板本身就是 MCP 服务，无需单独的仓库服务器。由于默认端点是回环地址，外部客户端必须与 After Effects 运行在同一台机器上。

Related MCP server: After Effects MCP Server

客户端连接

Claude Code 使用 URL 传输方式：

claude mcp add --transport http ae http://127.0.0.1:11488/mcp

Claude Desktop 可以通过系统安装的 Node 使用已发布的连接器，无需访问已安装的扩展目录。这种 npx -y ae-mcp-jkdg 形式包装了同一个无依赖的 host/stdio-shim.js：

{
  "mcpServers": {
    "ae": {
      "command": "npx",
      "args": ["-y", "ae-mcp-jkdg"]
    }
  }
}

或者，Claude Desktop 可以运行已安装扩展中内置的无依赖 stdio shim。将 command 设置为系统 Node 可执行文件，并将 args 指向扩展目录下的 host/stdio-shim.js：

{
  "mcpServers": {
    "ae": {
      "command": "node",
      "args": ["<installed-extension>/host/stdio-shim.js"],
      "env": {
        "AE_MCP_HTTP_URL": "http://127.0.0.1:11488/mcp"
      }
    }
  }
}

因此，Claude Desktop 需要在系统中安装 Node。该 shim 维护一个 stdio 请求队列，并将 MCP 响应转发给面板宿主。

面板功能

• ae_exec 用于受维护的 ExtendScript 操作。

• ae_execRecover 用于根据返回的 id 重试已派发的 ae_exec 失败。

• ae_nativeExec 用于冻结的原生 AEGP 原语。

• ae_previewFrame、ae_validateExpressions、结构化的 ae_read 和检查点。

• 内置技能以及本地 JSX Tool Library。

• 审批模式、活动历史、诊断和日志导出。

• 当本地 CLI 登录可用时，内置 Claude、Codex 和 OpenCode 通道。

公共 MCP 工具由 CEP 宿主提供。写入之后应进行独立的回读；可能产生副作用的失败必须在重试前核对清楚，Undo 必须单独执行并验证。

开发

安装两个 Node 工作区并构建面板：

(cd plugin/host && npm ci)
(cd plugin/panel && npm ci && npm run build)

对于本地 CEP 部署，请在宿主和面板构建完成后使用平台专属脚本：

.\scripts\install-plugin-dev.ps1

./scripts/install-plugin-dev-macos.sh

Adobe After Effects C/C++ Plug-in SDK 是开发者自行提供的输入，必须保留在本仓库之外。构建原生插件前请先验证：

node scripts/package/ae-sdk-input.mjs verify-input --platform macos-arm64

对于冻结的原生平面，请构建到仓库之外的新目录中。安装程序在 native-plugin-dev-v1 下维护事务状态；如果你安装构建结果，请保留返回的事务 ID：

AE_SDK_ARCHIVE=/absolute/path/AfterEffectsSDK.zip
AE_SDK_ROOT=/absolute/path/AfterEffectsSDK
BUILD_DIR=/private/tmp/ae-mcp-native-dev
TRANSACTION_ID="paste-the-transaction-id-here"
node native/ae-plugin/build-macos.mjs \
  --sdk-archive "$AE_SDK_ARCHIVE" \
  --sdk-root "$AE_SDK_ROOT" \
  --output "$BUILD_DIR"
# The install state root is native-plugin-dev-v1.
node native/ae-plugin/install-dev-macos.mjs install --artifact-dir "$BUILD_DIR"
node native/ae-plugin/install-dev-macos.mjs rollback \
  --transaction "$TRANSACTION_ID"

原生平面是冻结的；生成的 AEGP 协议文件已签入，capability-package 代码生成流水线不属于常规开发的一部分。

测试与打包

在本地运行聚焦的 Node 合约测试：

node --test scripts/package/test/verify-windows-zxp-stage.test.mjs
node --test scripts/package/test/zxp-payload-audit.test.mjs

Windows ZXP 暂存命令仅复制面板、宿主、JSX、共享模块、图标和生成的宿主资源。它会验证宿主对 Express 4.22.2 的精确依赖，并对 ZXP 进行一次签名：

.\scripts\package-zxp.ps1 -SkipSigning

签名后的 ZXP 除显式处理的 .aex 产物外，不得包含任何嵌套的原生二进制文件，且其大小必须保持在 20 MB 以下。

有关持续维护的操作细节，请参阅 Install、Reference 和 Release。

许可证

ae-mcp 以 MIT 许可证发布；请参阅 LICENSE。Adobe 的 CSInterface.js 保留其上游许可证声明。