ae-mcp

Английский | 简体中文

Однострочный промпт для настройки — вставьте это в Claude Code или другого ИИ-агента:

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 подключает панель CEP After Effects к ИИ-клиентам через локальную конечную точку MCP. Панель размещает сервис на http://127.0.0.1:11488/mcp; хост — это процесс Node с использованием Express, а состояние After Effects доступно через ExtendScript и замороженный нативный уровень AEGP.

Установка и первый запуск

1. Установите подписанный ZXP в After Effects.

2. Установите соответствующий нативный плагин рядом с выбранными для хоста плагинами After Effects — .aex в Windows, пакет AeMcpNative.plugin в macOS. Соблюдайте соответствие версий из одного релиза. ZXP не содержит двоичных файлов для платформ и устанавливается на обеих системах; только этот нативный плагин собирается для каждой платформы, и ae_nativeExec — единственный инструмент, которому он нужен. В Установке указан точный путь назначения для каждой платформы, а пакет macOS дополнительно требует снятия карантина с загруженного файла, прежде чем After Effects загрузит его.

3. Запустите After Effects и откройте Окно > Расширения > ae-mcp. Держите панель открытой, пока внешний клиент использует MCP.

4. Настройте одну из двух поддерживаемых ниже форм внешнего подключения.

Сама панель является MCP-сервисом. Отдельный сервер репозитория не нужен. Внешние клиенты должны работать на той же машине, что и After Effects, поскольку конечная точка по умолчанию использует loopback.

Related MCP server: After Effects MCP

Подключения клиентов

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, поставляемый в установленном расширении. Установите 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. Шим поддерживает одну очередь запросов stdio и пересылает ответы MCP хосту панели.

Возможности панели

• ae_exec для поддерживаемых операций ExtendScript.

• ae_execRecover для повторной попытки отправленного ae_exec, завершившегося сбоем, по возвращённому id.

• ae_nativeExec для замороженных нативных примитивов AEGP.

• ae_previewFrame, ae_validateExpressions, структурированный ae_read и контрольные точки.

• Встроенные навыки плюс локальная библиотека JSX Tool Library.

• Режимы подтверждения, история действий, диагностика и экспорт журналов.

• Встроенные каналы Claude, Codex и OpenCode при доступном локальном входе в их CLI.

Публичные инструменты 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; сохраните возвращённый идентификатор транзакции, если вы устанавливаете результат:

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 включены в репозиторий, а конвейер генерации кода пакетов возможностей не является частью обычной разработки.

Тесты и упаковка

Запустите локально целевые контрактные тесты Node:

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

Команда подготовки ZXP для Windows копирует только панель, хост, JSX, общие модули, значки и сгенерированные ресурсы хоста. Она проверяет, что хост использует точно указанную зависимость Express 4.22.2, и один раз подписывает ZXP:

.\scripts\package-zxp.ps1 -SkipSigning

Подписанный ZXP не должен содержать вложенных нативных двоичных файлов, кроме явно обрабатываемого артефакта .aex, и его размер не должен превышать 20 МБ.

Актуальные эксплуатационные подробности см. в разделах Установка, Справочник и Релиз.

Лицензия

ae-mcp распространяется под лицензией MIT; см. LICENSE. CSInterface.js от Adobe сохраняет уведомление о лицензии вышестоящего проекта.