remotion-mcp-server

MCP-сервер (Model Context Protocol), который даёт Claude возможность анализировать референсные видео и создавать брендированные Instagram Reels / YouTube Shorts с помощью Remotion (программное видео на React) — полностью из чата.

Укажите Claude референсный ролик, и он сможет:

1. Скачать его (yt-dlp), извлечь кадры и аудио, а также получить полную расшифровку (сначала субтитры YouTube, faster-whisper как запасной вариант для всего остального — Instagram, TikTok, локальные файлы).

2. Сгенерировать новую композицию в том же стиле — ролики с диалоговыми пузырями или факты/списки — в виде настоящего кода React/TSX.

3. Отрендерить её в MP4 с помощью Remotion.

4. Подсказать, как открыть её в Remotion Studio, чтобы просмотреть и отредактировать перед финальным рендером.

Никакого CapCut, никакого ручного монтажа — видео пишет Claude.

Инструменты

Оба инструмента create_* возвращают подсказку preview, которая сообщает Claude/вам, как открыть композицию в Remotion Studio (npm run dev → localhost:3000) перед тем, как считать рендер финальным.

Related MCP server: cutgent

Настройка

1. Клонируйте репозиторий и установите Python-зависимости

git clone https://github.com/<your-username>/remotion-mcp-server.git
cd remotion-mcp-server
pip install -r requirements.txt

Вам также понадобится ffmpeg в PATH (или установите imageio-ffmpeg — сервер автоматически переключится на него).

2. Настройте проект Remotion

Этому серверу нужен проект Remotion, в который он будет записывать сгенерированные композиции и из которого будет рендерить. В комплекте идёт готовый стартовый проект:

cd remotion-template
npm install
cd ..

Или укажите REMOTION_MCP_PROJECT на ваш собственный существующий проект Remotion — просто убедитесь, что в его Root.tsx присутствуют два маркерных комментария из remotion-template/src/Root.tsx.

3. Настройка (необязательно)

Скопируйте .env.example в .env и отредактируйте, если вы не используете значения по умолчанию (свои пути к yt-dlp/ffmpeg, другую папку проекта, водяной знак по умолчанию).

4. Зарегистрируйте в Claude

Добавьте в конфигурацию MCP в Claude Desktop / Claude Code:

{
  "mcpServers": {
    "remotion-video": {
      "command": "python",
      "args": ["/absolute/path/to/remotion-mcp-server/server.py"]
    }
  }
}

Перезапустите Claude и попросите его проанализировать референсный ролик и создать похожий в том же стиле.

Как это работает

• analyze_video скачивает видео с помощью yt-dlp, извлекает кадры и аудио с помощью ffmpeg, затем расшифровывает: сначала субтитры YouTube через youtube-transcript-api, а для всего остального — локальная транскрипция через faster-whisper.

• create_dialogue_reel / create_facts_reel создают по шаблону файл композиции .tsx, регистрируют его в Root.tsx проекта Remotion между маркерными комментариями и вызывают npx remotion render.

• Сгенерированные композиции появляются в Remotion Studio (npm run dev) в реальном времени через hot-reload — перезапуск не нужен — так что вы можете просмотреть и отредактировать их перед тем, как считать рендер финальным.

Лицензия

MIT — см. LICENSE.