Kinocut MCP
Локальный видеомонтаж для агентов: типизированные инструменты поверх FFmpeg, проверка качества и чек перед публикацией
- 251 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Запускает FFmpeg на ваших файлах и пишет результаты на диск, перезапись существующих выходов требует явного подтверждения параметром `overwrite`
- Дополнительные модули запускают Hyperframes, Whisper и локальные модели, а запрос агента может уйти провайдеру его модели
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/kinocutОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запускает FFmpeg на ваших файлах и пишет результаты на диск, перезапись существующих выходов требует явного подтверждения параметром `overwrite`
- Дополнительные модули запускают Hyperframes, Whisper и локальные модели, а запрос агента может уйти провайдеру его модели
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Kinocut дает агенту набор типизированных операций над видео вместо угадывания флагов FFmpeg. Агент обрезает, склеивает, масштабирует, добавляет субтитры и текст, нормализует звук, делает миниатюры и раскадровку. Каждая операция проверяется до запуска, а результат возвращается структурированным ответом с путем к файлу и чеком Video Receipt, в котором записаны входы, хеши и этапы. Все работает на вашем компьютере, облачного редактора и учетной записи нет. В базовой поставке три способа работы: MCP-сервер (`kino --mcp`), CLI `kino` со 177 командами и Python-клиент `Client`. Сервер по умолчанию регистрирует 20 основных инструментов, а переменная `KINOCUT_TOOLS=all` открывает все 205. Скрытые операции находит `search_tools`. Для безопасной публикации есть `video_quality_check` и `video_release_checkpoint`. Готовое видео перед выпуском должен посмотреть человек. Сверху лежат готовые сценарии: `video_shorts` собирает вертикальный ролик с субтитрами за один вызов, переупаковка превращает одну запись в варианты для Shorts, Reels и TikTok, а движок рабочих процессов исполняет JSON-описание цепочки и пишет чек. Отдельные режимы собирают двухкамерный монтаж из сшитого 360-видео и восстанавливают поврежденные клипы. В репозитории есть два скилла, `kinocut` и `kinocut-repurpose`. Раньше проект назывался mcp-video.
Для кого. Создателям подкастов, интервью и коротких роликов, которые хотят отдать агенту рутинный монтаж и сохранить контроль над качеством перед выпуском.
Подходит, если
- Запись интервью надо превратить в 45-секундный вертикальный клип с вшитыми субтитрами и нормализованным звуком
- Один подкаст нужен в трех форматах для Shorts, Reels и TikTok с манифестом и миниатюрами
- Монтаж собран агентом, и перед выпуском хочется получить отчет о качестве и чек с хешами
- Цепочку обрезки, масштабирования и титров надо описать в JSON и повторять в CI
- Съемка с двух камер 360 превращается в монтаж с переключением, наложением или разделением экрана
Не подходит, если
- Нужен ручной монтаж на таймлайне с подгонкой кадров: Kinocut управляется командами и не заменяет графический редактор
- Рендер должен идти в облаке на чужих серверах: все операции выполняются локально
- Исходник лежит в формате `.insv` или `.360`: Kinocut его отклоняет, сначала экспортируйте сшитый MP4
Пример запроса к агенту
Обрежь interview.mp4 до сильных 45 секунд, добавь вшитые субтитры, сделай вертикальный формат 9:16 и проверь качество перед экспортомMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
KINOCUT_TOOLS- Набор инструментов: `all` открывает все 205, `profile:editor` берет профиль редактора
MCP_VIDEO_HYPERFRAMES_COMMAND- Команда запуска Hyperframes, если его нет в `PATH`
Ограничения
- Нужны Python 3.11 или новее и FFmpeg в `PATH`. Инструменты Hyperframes дополнительно требуют Node.js 22 и командной строки Hyperframes.
- Дополнительные модули весят много: транскрибация через Whisper около 1 ГБ, выделение дорожек около 2 ГБ, повышение разрешения около 2 ГБ и только для Python до 3.12.
- По умолчанию агенту видны 20 инструментов из 205. Остальные включаются переменной `KINOCUT_TOOLS` или находятся через `search_tools`.
- Часть возможностей в README помечена как закрытая или частичная, например упаковка MCPB для Claude Desktop без подписи.
Как отключить. Уберите сервер командой `claude mcp remove kinocut` или удалите запись `kinocut` из MCP-конфигурации клиента. Пакет удаляется командой `pip uninstall kinocut`. Созданные видео и чеки остаются в рабочих каталогах и стираются вручную.
Частые вопросы
Как подключить Kinocut к Claude Code?
Поставьте FFmpeg и выполните `claude mcp add kinocut -- uvx --from kinocut kino --mcp`. Проверить окружение можно командой `uvx --from kinocut kino doctor`.
Как добавить Kinocut в Cursor или Claude Desktop?
Внесите в MCP-конфигурацию сервер `kinocut` с командой `uvx` и аргументами `--from kinocut kino --mcp`. Любой клиент MCP, умеющий запускать локальный stdio-сервер, подходит.
Почему агент видит только 20 инструментов?
Это сокращенный набор по умолчанию. Установите `KINOCUT_TOOLS=all`, чтобы увидеть все 205, или `KINOCUT_TOOLS=profile:editor`, чтобы взять профиль редактора.
Нужен ли ключ API или аккаунт?
Для основной части нет: Kinocut работает локально и не загружает видео в облако Kinocut. Платить придется только за дополнительных провайдеров и за модель в самом агенте, а тексты могут уходить провайдеру этой модели.
Что делать тем, кто ставил mcp-video?
Обновите совместимую оболочку `pip install --upgrade 'mcp-video==1.6.20'` и затем `pip install --force-reinstall --no-deps 'kinocut==1.16.5'`. Старые импорты, команда `mcp-video` и переменные `MCP_VIDEO_*` продолжают работать.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер, CLI и настольное приложение режут длинное видео или запись стрима на вертикальные клипы с субтитрами
Видеоредактор с открытым кодом и плагин Codex: агент открывает проект в боковой панели, импортирует медиа и правит монтаж пакетом
Скилл-видеорежиссер: по одной фразе собирает проект ролика с материалами, раскадровкой, титрами, анимацией, рендером через ffmpeg и проверкой
ffmpeg-skill — скилл и MCP-сервер: агент режет и склеивает видео, правит звук, делает субтитры и экспорт под TikTok, Reels и YouTube через локальный FFmpeg
Скилл для Claude Code: монтирует ролик с говорящей головой в короткое видео с динамичной графикой и сам оценивает монтаж
chengfeng-videocut
chengfeng-videocut-skills
Плагин для агента, который монтирует видео с говорящей головой: удаление оговорок, субтитры, графика на экране и сборка готового ролика
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Kinocut (эта карточка) | нет | не нужна | 251 | |
| ffmpeg-skill | нет | 4 619 | скилл и MCP-сервер с локальным FFmpeg для монтажа под TikTok и Reels; Kinocut добавляет чеки результата, проверки качества и рабочие процессы в JSON | |
| video-use | нет | 30 591 | скилл, который вырезает паузы, красит кадр и вшивает субтитры; Kinocut дает типизированные инструменты, MCP-сервер и CLI с 177 командами | |
| HyperFrames | нет | 79 556 | рисует ролики из HTML-композиций; Kinocut монтирует готовые видеофайлы и подключает Hyperframes как необязательный модуль |
Коротко о README
Документ открывается кратким определением и таблицей фактов о проекте. Дальше идут примеры вызовов, история выпусков с числами инструментов, сценарии с рабочими процессами и 360-видео, установка с таблицей дополнений, быстрый старт, список инструментов и ответы на частые вопросы.