🎬 Сервер After Effects MCP
✨ Сервер Model Context Protocol (MCP) для Adobe After Effects, который позволяет помощникам на основе искусственного интеллекта и другим приложениям управлять After Effects через стандартизированный протокол.
Оглавление
📦 Особенности
🎥 Основные особенности состава
- Создавайте композиции с пользовательскими настройками (размер, частота кадров, длительность, цвет фона)
- Список всех композиций в проекте
- Получите информацию о проекте , такую как частота кадров, размеры и продолжительность.
🧱 Управление слоями
- Создавайте текстовые слои с настраиваемыми свойствами (шрифт, размер, цвет, положение)
- Создание слоев фигур (прямоугольник, эллипс, многоугольник, звезда) с цветами и штрихами
- Создание сплошных/корректирующих слоев для фонов и эффектов
- Изменяйте свойства слоя , такие как положение, масштаб, поворот, непрозрачность и время.
🌀 Возможности анимации
- Установите ключевые кадры для свойств слоя (Положение, Масштаб, Вращение, Непрозрачность и т. д.)
- Применение выражений к свойствам слоя для динамической анимации
⚙️ Инструкции по настройке
🛠 Предварительные условия
- Adobe After Effects (2022 или более поздняя версия)
- Node.js (v14 или более поздняя версия)
- менеджер пакетов npm или yarn
📥 Установка
- Клонировать репозиторий
git clone https://github.com/yourusername/after-effects-mcp.git
cd after-effects-mcp
- Установить зависимости
npm install
# or
yarn install
- Построить проект
npm run build
# or
yarn build
- Установите панель After Effects
npm run install-bridge
# or
yarn install-bridge
🔧 Обновление конфигурации MCP
Перейдите к своему клиенту (например, Claude или Cursor) и обновите файл конфигурации.
{
"mcpServers": {
"AfterEffectsMCP": {
"command": "node",
"args": ["C:\\Users\\Dakkshin\\after-effects-mcp\\build\\index.js"]
}
}
}
▶️ Запуск сервера
- Запустите MCP-сервер
npm start
# or
yarn start
- Открыть After Effects
- Откройте панель MCP Bridge Auto.
- В After Effects перейдите в Окно > mcp-bridge-auto.jsx
- Панель будет автоматически проверять наличие команд каждые несколько секунд.
- Убедитесь, что флажок «Автоматически запускать команды» установлен.
🚀 Руководство по использованию
После запуска сервера и открытия панели MCP Bridge в After Effects вы можете управлять After Effects через протокол MCP. Это позволяет помощникам ИИ или пользовательским приложениям отправлять команды в After Effects.
📘 Создание композиций
Вы можете создавать новые композиции с пользовательскими настройками:
- Имя
- Ширина и высота (в пикселях)
- Частота кадров
- Продолжительность
- Цвет фона
Пример использования инструмента MCP (для разработчиков):
mcp_aftereffects_create_composition({
name: "My Composition",
width: 1920,
height: 1080,
frameRate: 30,
duration: 10
});
✍️ Работа со слоями
Вы можете создавать и изменять различные типы слоев:
Текстовые слои:
- Задайте текстовое содержимое, шрифт, размер и цвет
- Размещайте текст в любом месте композиции.
- Отрегулируйте время и непрозрачность
Формируем слои:
- Создание прямоугольников, эллипсов, многоугольников и звезд
- Установить цвета заливки и обводки
- Настройте размер и положение
Сплошные слои:
- Создать фоновые цвета
- Создавайте корректирующие слои для эффектов
🕹 Анимация
Вы можете анимировать слои с помощью:
Ключевые кадры:
- Установка значений свойств в определенное время
- Создавайте изменения движения, масштабирования, вращения и непрозрачности
- Управляйте временем анимации
Выражения:
- Применение выражений JavaScript к свойствам
- Создавайте динамичные, процедурные анимации
- Свяжите значения свойств друг с другом
🛠 Доступные инструменты MCP
| Команда | Описание |
|---|
| `создать-композицию` | Создать новую композицию |
| `запустить-скрипт` | Запустить JS-скрипт внутри AE |
| `получить-результаты` | Получить результаты скрипта |
| `получить-помощь` | Справка по доступным командам |
| `setLayerKeyframe` | Добавить ключевой кадр к свойству слоя |
| `setLayerExpression` | Добавить/удалить выражения из свойств |
👨💻 Для разработчиков
🧩 Структура проекта
src/index.ts : Реализация сервера MCPsrc/scripts/mcp-bridge-auto.jsx : Скрипт основной панели After Effectsinstall-bridge.js : Скрипт для установки панели в After Effects
📦 Создание проекта
npm run build
# or
yarn build
🤝 Вклад
Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.
Лицензия
Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.