Skip to main content
Glama
README.md
<img src="assets/banner.svg" alt="AeMCP — MCP-сервер для Adobe After Effects" width="100%">

# 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, отдельные тулы на каждый метод
только раздувают сервер.

## Установка

```powershell
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 её не загрузит.

## Запуск

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

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

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

## Примеры `ae_eval`

```js
// список композиций
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)

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

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

```powershell
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](LICENSE).