AeMCP
by w1zzyakik
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).
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues