ae-mcp

Продвинутый MCP-сервер для Adobe After Effects. Он даёт ассистенту набор инструментов редактора: читать проект, создавать и оснащать слои, задавать ключевые кадры с реальными кривыми скорости, анимировать текст, строить векторные фигуры, применять эффекты и выражения, управлять нативными меню — и увидеть результат через снимки, возвращаемые прямо в разговор.

Architecture

Assistant (MCP)
      │  stdio
┌─────▼──────────────────────────────┐
│  ae-mcp server (Node/TypeScript)   │   easing, SVG, presets, schemas
└─────┬──────────────────────────────┘
      │  1. HTTP 127.0.0.1:9782  (CEP transport, primary)
      │  2. watched JSON files    (ScriptUI transport, fallback)
┌─────▼──────────────────────────────┐
│  bridge inside After Effects       │   CEP panel or ScriptUI panel
└─────┬──────────────────────────────┘
      │  $.evalFile + AEMCP.runFile()
┌─────▼──────────────────────────────┐
│  ExtendScript kernel (AEMCP)       │   ~4,000 lines, 60+ commands
└────────────────────────────────────┘

Three principles:

• Основная работа остаётся в Node. Преобразование SVG, математика плавности, пресеты анимации — всё готовится на стороне сервера; ядро ExtendScript просто выполняет.

• Обмен происходит через файлы. Запросы и ответы передаются как JSON на диске, избегая экранирования и ограничений размера evalScript. HTTP только запускает выполнение.

• Всё атомарно. Каждый запрос — даже пакет из 50 операций — выполняется в одной группе отмены: одно Ctrl+Z отменяет всё.

Bridge auth token

HTTP-сервер панели CEP слушает 127.0.0.1 и запускает команды в After Effects (включая ae_eval, который выполняет произвольный ExtendScript). Чтобы веб-страница, открытая в браузере, пока AE работает, не могла управлять мостом через обычный fetch(), панель генерирует случайный токен при первом запуске, сохраняет его в Documents/ae-mcp/bridge/token.txt и публикует в bridge.json (поле token). Каждый POST /run или POST /reload должен содержать заголовок X-AE-MCP-Token; без него сервер возвращает 401. MCP-клиент (src/bridge/client.ts) читает токен из bridge.json и отправляет его автоматически — ручная настройка не нужна. Токен сохраняется, пока существует token.txt; удалите его, чтобы принудительно перегенерировать при следующем запуске панели.

Резервный файловый транспорт (req//res/) не имеет токена: он полагается на права ОС на папку Documents пользователя, которые уже блокируют доступ из другой учётной записи.

Related MCP server: After Effects MCP Server

Install

npm install
npm run build
npm run install-bridge      # installs the CEP extension + ScriptUI panel + kernel

Затем в After Effects:

• Транспорт CEP (рекомендуется) — перезапустите After Effects. Мост запускается сам, без окна. Window > Extensions > AE MCP Bridge показывает статус, порт и журнал.

• Транспорт ScriptUI (без перезапуска) — File > Scripts > Run Script File…, затем выберите Documents/ae-mcp/AE MCP Bridge.jsx. Панель сразу начинает опрос.

Зарегистрируйте сервер в вашем MCP-клиенте:

claude mcp add ae-mcp -- node "/path/to/ae-mcp/build/index.js"

npm run install-bridge также копирует панель в Scripts/ScriptUI Panels любой обнаруженной установки After Effects, делая её закрепляемой. Эта копия находится в Program Files и требует прав администратора; если она не удастся, ничто другое не пострадает.

Tools

What sets this apart

Реальные кривые скорости. ease: "expo.out" не просто применяет Easy Ease — кривая Безье преобразуется во влияние и скорость по каждому измерению, вычисленные из средней скорости сегмента, точно так же, как при ручной настройке в Graph Editor.

Относительные значения. slideIn использует mode: "offset": анимация строится на существующей позиции слоя, а не перезаписывает её. Та же идея для масштаба с mode: "multiply".

SVG становится реальными фигурами. ae_shape action=svg преобразует path, rect, circle, ellipse, line, polyline, polygon, группы и их трансформации в нативные редактируемые слои-фигуры, с заливками, обводками, штрихами и дугами, аппроксимированными кривыми Безье.

Визуальная обратная связь. ae_render action=snapshot рендерит композицию и возвращает изображение напрямую: ассистент сравнивает свой результат с эталоном и исправляет, а не работает вслепую.

Атомарные пакеты со ссылками. Целая сцена строится за один цикл, каждый шаг может повторно использовать результат предыдущего через {{0.index}} или {{prev.id}}.

Development

npm run build          # kernel + TypeScript
npm run build:kernel   # kernel only (also checks its syntax)
node scripts/ae.mjs status                       # bridge status
node scripts/ae.mjs layer.list '{"comp":"My Comp"}'
node scripts/selftest.mjs                        # full validation against AE
node scripts/selftest.mjs --keep --only=shape    # subset, keeps the comp

Ядро разбито на модули в host/kernel/ и объединяется в host/aemcp-kernel.jsx с помощью scripts/build-kernel.mjs. Оно должно оставаться совместимым с ES3: никаких let/const, никакого Array.prototype.map, никакого нативного JSON (полифилл предоставляется в прелюдии).

Troubleshooting