mcp-video-editor
MCP-сервер на 59 инструментов для монтажа в CapCut и OpenCut: дорожки, клипы, текст, переходы и озвучка из Cursor и Codex.
- 80 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Сервер читает и перезаписывает файлы проектов и пишет рендеры на диск, а озвучка отправляет текст внешнему сервису.
Установка
- Работает в
Ручная установка
npm installСборка из исходников: `npm run build`, затем `bash scripts/install-unix.sh` или `scripts/install-windows.ps1`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер читает и перезаписывает файлы проектов и пишет рендеры на диск, а озвучка отправляет текст внешнему сервису.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер читает и пишет файлы проектов CapCut и OpenCut через stdio. Агент управляет проектами, дорожками и клипами (`add_clip`, `split_clip`, `trim_clip`), подписями и стилем текста, переходами, фильтрами и эффектами, звуком с плавным входом и выходом, а потом готовит параметры экспорта. Инструменты `get_project_state` и `get_timeline` дают ему прочитать текущее состояние. Есть каталог из 20 эффектов с пометкой, безопасны ли они для лица, озвучка через OpenAI или ElevenLabs (`generate_voice`), библиотека готовых планов и сборка видео движками Remotion, HyperFrames и Motion через `render_project`. Все записывающие инструменты по умолчанию работают в режиме `dryRun: true` и показывают, что изменится, пока вы не передадите `dryRun: false`.
Для кого. Монтажерам и авторам коротких видео, которые собирают ролики в CapCut или OpenCut и хотят поручить рутину нарезки и подписей агенту.
Подходит, если
- В проект CapCut добавляют дорожку подписей и стилизуют текст по шаблону.
- Клипы нарезают и сдвигают по таймлайну, а потом смотрят план без записи на диск.
- Закадровый текст озвучивают через ElevenLabs и кладут MP3 в экспорт.
- Один проект собирают через Remotion, не открывая редактор.
Не подходит, если
- Монтаж идет в Premiere или Filmora: их проекты сервер не читает.
- Нужен готовый видеофайл от `export_project`: он только ставит запрос в очередь.
- CapCut открыт и правит тот же черновик в этот момент.
Пример запроса к агенту
Открой проект CapCut, обрежь первый клип до десяти секунд, добавь титр на второй секунде и покажи план без сохранения.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
MCP_VIDEO_EXPORT_DIR- Каталог для рендеров и задач экспорта.
MCP_VIDEO_BACKUP_DIR- Каталог резервных копий проектов.
Ограничения
Поддерживаются только CapCut и OpenCut. У CapCut нет официального API, сервер правит файл `draft_content.json`, и при записи редактор лучше закрыть, иначе файл может быть заблокирован. Схема черновиков меняется между версиями CapCut, поэтому новые поля могут не читаться. Инструмент `export_project` лишь ставит запрос в очередь и видеофайл не создает, настоящий рендер идет через `render_project`. Экспорт временной шкалы в XML для Premiere и Filmora помечен бета и не проверялся в самих программах. Озвучка требует ключа и сети. Установка собирается из исходников: `npm install`, `npm run build` и скрипт установки для клиентов.
Как отключить. Удалите запись `mcp-video-editor` из конфигурации клиента (Cursor, Codex, Claude Desktop и других). Резервные копии проектов остаются в `MCP_VIDEO_BACKUP_DIR` и стираются вручную.
Частые вопросы
С какими клиентами работает?
Cursor, Claude Desktop, Codex CLI, Antigravity, OpenCode, KiloCode, Qwen Code и ZCode CLI. Qwen Code и ZCode правят вручную, объединяя блок `mcpServers` с имеющимся файлом.
Что такое dryRun?
Параметр у каждого записывающего инструмента. По умолчанию `true`: изменения лишь обновляют кеш в памяти, а файл проекта не трогают, пока вы не передадите `dryRun: false`.
Делает ли сервер резервные копии?
Да, при `dryRun: false` существующий файл копируется перед перезаписью, а `delete_project` сохраняет проект целиком. Копии не удаляются сами.
Где лежат готовые рендеры?
В каталоге `MCP_VIDEO_EXPORT_DIR`, по умолчанию `Videos\mcp-video-editor` в профиле пользователя. Туда же пишутся задачи экспорта и MP3 озвучки.
Поддерживается ли Premiere?
Нет. Есть бета-экспорт `export_timeline_xml` в XML формата FCP7, но импорт в Premiere и Filmora ни разу не проверялся, и текст, стикеры и переходы при обмене теряются.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыSmartCut MCP
SmartCut MCP Server
MCP-сервер монтирует видео с говорящим человеком в проекте CapCut: по автосубтитрам режет паузы и повторные дубли.
MCP-сервер, CLI и настольное приложение режут длинное видео или запись стрима на вертикальные клипы с субтитрами
ClipForge MCP
ClipForge
ClipForge MCP собирает вертикальное видео из темы или ссылки на товар: сток, озвучка Edge TTS и субтитры без ключей, сборка через FFmpeg
MCP-сервер для видеомонтажа внутри бесплатного редактора Concat: агент режет клипы, добавляет титры и субтитры, ставит ключевые кадры и экспортирует видео
CartCut MCP после обновления редактора создает новое соединение при следующем вызове и запрашивает обновление списка инструментов.
VidMoat MCP
Vidmoat MCP
Удаленный MCP-сервер облачного видеоредактора: агент загружает материал, правит таймлайн, смотрит кадры и рендерит MP4
Коротко о README
Описаны возможности по таблице инструментов, документация, история версий, схема работы, установка для Windows и Unix, переменные окружения и ограничения. Раздел безопасности объясняет режим dryRun и резервные копии.