Remotion Video Production MCP Server

Высококлассный MCP-сервер Model Context Protocol (MCP), который выступает интеллектуалльным мостом для ИИ-агентоов: анализирует биты аудио, синтезирует голоса с помощью Google Gemini TTS и программно создает и рендерит профенсиональные видоо с использыванием Ремotion (v4.0+) и React.

Key Features

• б Программное создания проектов: Ромплектные React/Remotion видоо-проекты с нулной конфицигурацией и встроенными соотношениями: TikTok/Reels (tiktok-916), YouTube (youtube-169) и Social (social-11).

• 🎙️ Инграция Gemini 3.1 Flash TTS: Генрация высококачественных озвученных диалогов сцен с региональными акцентами и пословными таймкодами для кинетических субтитров.

• а Синхронизация битов аудио (Librosa): Анализ фоново музыки для извлечения BPM, границы битов, спадов/подъёмов энергии RMS и рекомендация пондрочно точных моттаей сцен.

• 📸 Мгновенные снимки превью: Рендер кадров (PNG/JPEG/WebP) на любо моме индексе кадря для визуалъной проеверки ИИ.

• б Фоноый рендериг: Программная компиляция качественн видоо MP4/WebM с контроем многопточности и оттуслежением проса.

-* )

Ребилизации

То запуска этого MCP-сервера и рендеринга видоо, на хосневом окружении должн иметь:

1. Node.js (v18.0.0 или выше) и npm.

2. Python 3 (рекомендуется v3.10+) со следущими устнами пакетами:

   pip install librosa numpy scipy google-genai

3. Ремен-браузерные зависимости: Для запуска headless Chrome тревуеться Chromium. Устанthать его черз CLI:

   npx remotion browser ensure

📦 Мгновенная установка в одну команду (рекомендуется)

Скопируйте и встасте одну команду в терминл. Ес ли Git, Node.js, npm или Python отуствуют, скрипт автоматически устантовит их за вас!

macOS / Linux (Terminal)

curl -fsSL https://raw.githubusercontent.com/ivalenzuela/remotion-mcp-server/main/autoinstall.sh | bash

Windows (PowerShell)

iwr -useb https://raw.githubusercontent.com/ivalenzuela/remotion-mcp-server/main/autoinstall.ps1 | iex

Нульевое ручное вмешательство: Сет автоматически ищий отсутвующие превии (Git, Node.js, npm, Python 3) и устанл.т их обычно Homebrew / Winget / Chocolatey. Затем он провает все пути Antigravity (.gemini/, .antiigravity-ide/, .antiigravity/), Claude Desktop и системные пути, устан.т Python-Audio-зависимости, проверяет готовсть Chromium и бескомпротив но и CMLL cri).

Ручная установка (альтерн)

1. Скомпируйте сервер:

   git clone https://github.com/ivalenzuela/remotion-mcp-server.git
   cd remotion-mcp-server
   node install.js

2. ЗарегистрируйтеСвой AI-клиенте

Добавьте конфигурацию сервера в фай настроек MCP (напрмер, claude_desktop_config.json, antiigravity.json или .mcp.json):

{
  "mcpServers": {
    "remotion": {
      "command": "node",
      "args": ["/path/to/remotion-mcp-server/dist/index.js"],
      "env": {
        "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY_HERE"
      }
    }
  }
}

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

2. remotion_scaffold_project

Создаёт полный React/Remotion-проект с готовыми темплатами и стандартными компонентами макета, ататоматически устан.авливает npm-dependencies.

• Аргументы:

  • проектName (string, required): Имя папки про(екта.

  • template (enum: tiktok-916, youtube-169, social-11, required): Соотношение сторон.

  • targetDir (string, required): Путь к родительской дирестории.

2. remotion_analyze_audio

Исполниет обрабостку сигл аудио с via Python Librosa для 9от. Input and output: BPM, beat frames, energy profiles, recomеендованн номера сцей и выравнивание SRT субтитров.

• Аргументы:

  • audioPath (string, required): Путь к входн. дорож.

  • srt (string, optional): Путь к файлу SRT.

  • outputPath (string, optional): Путь к выход, JSON-анализу.

  • fps (number, default 30): Частота кадров композ.ции.

  • leinSceneDuration (number, default3.5): Minimum всп. время мекду склейками сц.

3. remotion_generate_tts

Синтезирует реч спец помощью Google Gemini 3.1 Flash TTS (gemini-3.1-flash-tts-preview) и возращает по словные таймкоды с учётом длин символов. Автоматически оступает на чистый синтезированны audio, если GEMINI_API_KEY отуст.

• Аргументы:

  • text (string, required): Текст диалога для синтеза.

  • outputPath (string, required): Путь к сохраемному .wav-файлу.

  • voice (string, default "Puck"): Имя предустановленного голоса Gemini.

  • accent (string, optional): Опциональная инструкция по региональному акценту.

  • fps (number, default 30): Частота кадров.

4. remotion_preview_frame

Рендерит статичный снимок (PNG/JPEG/WebP) определённого кадра композиции с помощью CLI Remotion.

• Аргументы:

  • projectDir (string, required): Путь к проекту Remotion.

  • compositionId (string, required): ID целевой композиции.

  • frame (number, default 0): Индекс кадра для захвата.

  • imageFormat (enum: png, jpeg, webp, default png): Формат изображения.

  • props (object, optional): Входные React-pip.

5. remotion_render_video

Компилирует композицию в производственное видео (MP4/WebM).

• Аргументы:

  • projectDir (string, required): Путь к проекту Remotion.

  • compositionId (string, required): ID целевой композиции.

  • outputPath (string, optional): Путь к выходному видоо.

  • conurrency (number/string, default "auto"): Кол-во потоков CPU для применения.

  • codec (string, default "h264"): Тулевой кодек.

  • props (object, optional): Входные React props.

б Предустановленные компонует RT (React)

Сгенерированные проекты включают evol:

1. SSTrail: Пословное актичное масштабирование и светящие свечения тени («Efexo Луп PRO») двойных. Субыстры.

2. KenBurnsImage: Чистое масштабирован (на инте ро р, без CSS).

3. AudioSpectrum: Визуальные полосы спектра звука, реактивно синхронизир. с очеред.

4. LowerThird: Элегантные «нижнее трети» для профилей соцсетей или имён.

🧪 Тестирование и проверки

Запустите E2E-набор тестов для проверки работы инструмента, резолвции пути и CLI-рендера:

npm test

📄 Лицензия

Проект лицензируется на условиях MIT License.