ae-mcp — MCP для Adobe After Effects
ae-mcp
Панель для After Effects с MCP-сервером: агент читает проект, строит анимации, сверяет кадры и сохраняет скрипты
- 96 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент выполняет ExtendScript и нативный код внутри проекта After Effects и может менять и удалять слои и композиции
- Рабочая папка чата и экспорт диагностики лежат в каталоге проекта
Установка
- Работает в
Ручная установка
claude mcp add --transport http ae http://127.0.0.1:11488/mcpСначала установите ZXP из релиза и откройте панель ae-mcp в After Effects.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент выполняет ExtendScript и нативный код внутри проекта After Effects и может менять и удалять слои и композиции
- Рабочая папка чата и экспорт диагностики лежат в каталоге проекта
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
ae-mcp — открытое расширение CEP, которое подключает запущенный проект After Effects к MCP. Чат с Claude, Codex или OpenCode встроен в панель, а внешний MCP-клиент подключается по адресу `http://127.0.0.1:11488/mcp`. Сама панель служит сервером, отдельный серверный процесс не нужен. Агент читает проекты, композиции, слои, свойства и ключевые кадры с пагинацией, сортировкой и фильтрами, выполняет ExtendScript для обычных операций, а для точных координат времени и объектов использует нативные инструменты AEGP. Кадры композиции экспортируются в PNG, их можно семплировать сеткой по времени и сравнивать пиксель за пикселем. Контрольные точки сохраненных проектов и идентификатор `recoveryId` помогают разобрать неудачную операцию и вернуть состояние. Удачные скрипты попадают в библиотеку инструментов: их можно закрепить, архивировать, экспортировать и импортировать. В панели есть подтверждения действий, лента активности, история диалога и экспорт диагностики. Публичных инструментов 16; последние три, `ae_instances`, `ae_workspace` и `ae_readJob`, нужны для нескольких экземпляров After Effects.
Для кого. Моушн-дизайнеры и монтажеры на After Effects, которые хотят поручить агенту сборку композиций, ключевых кадров и выражений и проверять результат по кадрам.
Подходит, если
- Нужно собрать композицию с текстом и анимацией появления, а затем сверить ключевые кадры
- Надо сравнить два варианта анимации по пикселям в нескольких кадрах
- Агент ошибся, и нужно вернуть проект к контрольной точке
- Повторяющуюся операцию хочется сохранить как инструмент в библиотеке
- Работаете с несколькими открытыми проектами After Effects и нужен маршрут для каждого
Не подходит, если
- Нет установленного After Effects: сервер работает только вместе с запущенной панелью
- Клиент находится на другой машине: по умолчанию адрес слушает только loopback
- Нужен окончательный рендер: README советует выполнять рендер отдельно, вне группы отмены
- Нужна проверка на Mac в сценариях с фоновыми рабочими процессами: они не подтверждены
Пример запроса к агенту
Создай композицию с текстом Hello AE: за секунду проявление и подъем в центр. Считай ключевые кадры и проверь анимацию превью из шести кадров.MCP
- Транспорт
- http, stdio
- Авторизация
- не нужна
Ограничения
Расширение ставится из ZXP-файла релиза и работает только при открытой панели `Window > Extensions > ae-mcp`; закрытая панель отключает MCP. Для инструмента `ae_nativeExec` нужен отдельный нативный плагин: файл `.aex` для Windows x64 или `.plugin` для macOS arm64 (macOS 14 и новее). ZXP весит около 60 МБ, в него входит среда OpenCode для Windows, на macOS OpenCode берется из PATH. Автор отмечает, что сценарии рабочих процессов на Mac не проверены. Скрипты выполняются в проекте, поэтому пробуйте их на тестовой копии, а подтверждения в панели включайте до первых правок.
Как отключить. Закройте панель ae-mcp и удалите расширение из менеджера расширений Adobe. Из конфигурации клиента уберите запись `ae`, например командой `claude mcp remove ae`.
Частые вопросы
Как подключить ae-mcp к Claude Code?
Установите ZXP из релиза, откройте панель ae-mcp в After Effects и выполните `claude mcp add --transport http ae http://127.0.0.1:11488/mcp`. Затем вызовите `ae_status`, чтобы проверить связь.
Нужно ли держать панель открытой?
Да. Панель и есть MCP-сервер, при ее закрытии клиент отключается, а After Effects автоматически не открывается.
Можно ли откатить неудачную правку?
Да. Инструмент создает контрольные точки сохраненных проектов и фиксирует скрипты, которые завершились ошибкой. По `recoveryId` проект можно проверить, исправить или вернуть.
Для чего нужен нативный плагин?
Для инструмента `ae_nativeExec`, который работает через AEGP и задает точное время и объекты. Плагин ставится отдельно от ZXP: `.aex` для Windows x64 и `.plugin` для macOS arm64.
Работает ли с несколькими проектами?
Да, с версии 0.11. Инструмент `ae_instances` находит и запускает экземпляры, `ae_workspace` привязывает проект, а `context_id` передается в следующие вызовы.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер подключает агента к запущенному Adobe After Effects: разбор проекта, правка слоев и ключей, выражения и рендер кадров.
MCP-сервер и панель управляют проектом Adobe After Effects: агент читает композицию и собирает анимацию как обычные слои и ключи.
AE MCP Bridge подключает агента к открытому After Effects: чтение проекта, кадры в PNG, правка ключей и выражений.
MCP-сервер для Adobe After Effects: создание композиций, слоев, ключевых кадров и выражений через агента
MCP for Adobe Premiere Pro — монтаж через агента
MCP for Adobe Premiere Pro
Локальный MCP-сервер дает Claude, Cursor и Codex читать проект Premiere Pro, править таймлайн и экспортировать результат
MCP-сервер управляет локальными проектами Adobe Premiere Pro из Claude, Codex и других MCP-клиентов
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| ae-mcp — MCP для Adobe After Effects (эта карточка) | нет | не нужна | 96 | |
| After Effects MCP Server | нет | не нужна | 888 | MCP-сервер для After Effects без панели с чатом и библиотеки инструментов |
| MCP for Adobe Premiere Pro — монтаж через агента | нет | не нужна | 525 | MCP для монтажа в Premiere Pro |
Коротко о README
В начале README лежит готовая подсказка для автоматической установки в любой клиент. Дальше описаны возможности, пример задачи со скриншотами, история версий 0.11.x и порядок установки. Раздел о подключении показывает адрес для Streamable HTTP и stdio-коннектор, схема объясняет работу узла CEP, ExtendScript, AEGP и рабочих процессов только для чтения.