Skip to main content
Glama

AeMCP — MCP-сервер для Adobe After Effects

Управление AE из любого MCP-клиента (opencode, Claude Desktop, Cursor…) и скриншоты: окна программы и кадра предпросмотра.

MCP-клиент  ──stdio──>  server.py  ──WebSocket:7861──>  CEP-панель AeMCP  ──>  ExtendScript в AE

Три инструмента:

Инструмент

Что делает

ae_eval(code, timeout=60)

выполняет любой ExtendScript в открытом AE, результат возвращает JSON

ae_screenshot(max_width=1600)

скриншот окна AE (вьюер + таймлайн + панели)

ae_preview(time=None, max_width=1600)

кадр активной композиции (CompItem.saveFrameToPng)

Всё «создать композицию / добавить слой / навесить эффект / настроить кейфреймы / отрендерить» делается через ae_eval — это полный scripting API After Effects, отдельные тулы на каждый метод только раздувают сервер.

Установка

git clone https://github.com/w1zzyakik/AeMCP
cd aemcp
py -3.11 -m pip install -r requirements.txt
powershell -ExecutionPolicy Bypass -File .\install.ps1   # копирует панель в %APPDATA%\Adobe\CEP\extensions

install.ps1 также ставит PlayerDebugMode=1 — панель не подписана, иначе AE её не загрузит.

Related MCP server: ae-mcp

Запуск

  1. Открыть After Effects → Window > Extensions > AeMCP. Панель должна показать connected :7861 (после каждого запуска AE — один клик; CEP-панели не умеют стартовать сами).

  2. Подключить сервер в конфиг MCP-клиента. opencode (opencode.json):

"mcp": {
  "after-effects": {
    "type": "local",
    "command": ["C:/Program Files/Python311/python.exe", "F:/AeMCP/server.py"],
    "enabled": true
  }
}

Если панель не открыта, инструменты вернут ошибку «Панель AeMCP не подключена» — это нормально.

Примеры ae_eval

// список композиций
var out = []; for (var i = 1; i <= app.project.numItems; i++) out.push(app.project.item(i).name);
out

// новая композиция 1920x1080 на 10 секунд
var c = app.project.items.addComp("Test", 1920, 1080, 1, 10, 29.97); c.openInViewer(); c.name

// слой-текст
app.project.activeItem.layers.addText("Привет")

// эффект Glow на активный слой
app.project.activeItem.selectedLayers[0].Effects.addProperty("ADBE Glo2").property("Radius")

// кейфрейм непрозрачности
var l = app.project.activeItem.selectedLayers[0];
var op = l.property("ADBE Transform Group").property("ADBE Opacity");
op.setValueAtTime(0, 0); op.setValueAtTime(2, 100); "ok"

// рендер: очередь + Output Module + Render Queue → render()
var q = app.project.renderQueue; q.items.add(app.project.activeItem); q.render()

Код выполняется как выражение (как в консоли): возвращается значение последнего выражения. Если пишете return, код автоматически заворачивается в функцию — работает и так, и так.

Ограничения, о которых стоит знать

  • ExtendScript = ES3. Нет JSON, let/const, стрелок, Array.isArray. Возвращаемый результат сериализует сам AeMCP: глубина 6, до 300 элементов на уровень, объекты AE отдают свойства (функции пропускаются), циклические ссылки → "<circular>".

  • AE 17+ (manifest: [17.0, 99.9]), проверено на 2022 (22.x). Порт моста 7861, только localhost.

  • ae_screenshot: сначала PrintWindow (снимает окно даже перекрытым); если AE рисует вьюер через GPU и снимок получается чёрным — фолбэк на захват с экрана, тогда окно AE должно быть видимым и не перекрытым.

  • ae_preview требует открытую (двойным кликом) композицию — берётся app.project.activeItem.

  • Скриншоты складываются в out/.

  • Панель читает jsx/host.jsx при открытии: после правки бриджа закройте и снова откройте панель (перезагрузка через $.evalFile из работающей панели вешает ExtendScript-очередь AE — не делать).

Самопроверки (без After Effects)

node tests\host.selfcheck.js     # сериализатор host.jsx
py -3.11 tests\server.selftest.py # MCP-часть + фейковая панель
py -3.11 tests\capture.selfcheck.py # захват окна через Win32

Живой прогон кода в AE (панель должна быть открыта):

py -3.11 tests\probe.py "app.version" "!preview 1.0" "!screenshot"

Файлы

  • server.py — MCP-сервер, WebSocket-хаб, захват окна, saveFrameToPng.

  • cep/AeMCP/ — панель: manifest.xml, index.html, js/main.js (WS-клиент), jsx/host.jsx (ExtendScript-часть: AeMCP.run(code) → JSON).

  • install.ps1 — установка панели.

Лицензия

MIT — см. LICENSE.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers