Сервер After Effects MCP

Сервер, реализующий протокол MCP (Model Context Protocol) для управления Adobe After Effects из AI-ассистентов и других приложений.

Возможности

Управление композициями

• Создание композиций с произвольными параметрами: размер, частота кадров, длительность, цвет фона.
• Просмотр списка всех композиций в проекте.
• Получение информации о проекте: частота кадров, размеры, длительность.

Работа со слоями

• Текстовые слои: настройка шрифта, размера, цвета, позиции.
• Слои-фигуры: прямоугольник, эллипс, многоугольник, звезда; настройка заливки и обводки.
• Сплошные слои: фоновые цвета, корректирующие слои для эффектов.
• Модификация свойств слоёв: положение, масштаб, поворот, непрозрачность, тайминг.

Анимация

• Ключевые кадры для свойств: Position, Scale, Rotation, Opacity и др.
• Выражения (expressions): применение JavaScript-выражений к свойствам для динамической анимации.

Установка

Требования

• Adobe After Effects 2022 или новее.
• Node.js v14 или выше.
• npm или yarn.

Пошаговая инструкция

1. Клонируйте репозиторий:

   git clone https://github.com/yourusername/after-effects-mcp.git
   cd after-effects-mcp
   

2. Установите зависимости:

   npm install
   # или
   yarn install
   

3. Соберите проект:

   npm run build
   # или
   yarn build
   

4. Установите панель в After Effects:

   npm run install-bridge
   # или
   yarn install-bridge
   

   Скрипты будут скопированы в установку After Effects.

Настройка MCP-клиента

Добавьте конфигурацию в вашем клиенте (например, Claude, Cursor):

{
  "mcpServers": {
    "AfterEffectsMCP": {
      "command": "node",
      "args": ["C:\\Users\\Dakkshin\\after-effects-mcp\\build\\index.js"]
    }
  }
}

Запуск

1. Запустите MCP-сервер:

   npm start
   # или
   yarn start
   

2. Откройте After Effects.

3. Откройте панель MCP Bridge: Window > mcp-bridge-auto.jsx.

4. Убедитесь, что галочка «Auto-run commands» включена — панель будет автоматически проверять команды каждые несколько секунд.

Использование

Создание композиции

Пример вызова MCP-инструмента:

mcp_aftereffects_create_composition({
  name: "My Composition",
  width: 1920,
  height: 1080,
  frameRate: 30,
  duration: 10
});

Работа со слоями

• Текстовые слои: содержимое, шрифт, размер, цвет, позиция, непрозрачность, тайминг.
• Слои-фигуры: прямоугольники, эллипсы, многоугольники, звёзды; заливка и обводка.
• Сплошные слои: заливка цветом, корректирующие слои для эффектов.

Анимация

• Ключевые кадры: установка значений свойств в определённые моменты времени для движения, масштабирования, вращения, изменения непрозрачности.
• Выражения: динамические, процедурные анимации через JavaScript; связывание значений свойств между собой.

Доступные MCP-инструменты

Для разработчиков

Структура проекта

• src/index.ts — реализация MCP-сервера.
• src/scripts/mcp-bridge-auto.jsx — основной скрипт панели After Effects.
• install-bridge.js — скрипт для установки панели в After Effects.

Сборка

npm run build
# или
yarn build

Участие в разработке

Приветствуются пул-реквесты. Пожалуйста, создавайте их по правилам проекта.

Лицензия

Проект распространяется под лицензией MIT. Подробнее — в файле LICENSE.