MS

matrodrigs/shotcut-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

25 stars 4 forks Качество 71 Тренд 31MIT

Транзакционный MCP-сервер для создания, редактирования, проверки, предварительного просмотра и рендеринга проектов Shotcut.

Обзор

Редактирование видео через протокол Model Context. Создавайте, редактируйте, проверяйте, просматривайте и визуализируйте сохраненные проекты Shotcut через своего помощника ИИ. Результатом остается редактируемая временная шкала .mlt с транзакционными записями, которые защищают проект по мере его работы. Короткий экспорт H.264, созданный из родной временной шкалы Shotcut, отредактированной через Shotcut MCP. [[Т0]] Вам нужен , (рекомендуется, в комплекте с MLT) и клиент MCP, который поддерживает локальные серверы. Shotcut включает в себя необходимые средства массовой информации, кодеки и фильтры. Никаких дополнительных пакетов Python не требуется. Руководство по установке включает команды для Windows, macOS и Linux. Для запуска сервера не требуется установка pip. Для проверки источника в руководстве также показано, как проверить Python и Shotcut со скриптами /hotcut mcp server.py -check перед подключением MCP. Запустите shotcut status и shotcut doctor. Сообщите о путях, версиях и неудачных проверках времени выполнения.

Обзор (машинный перевод)

Редактирование видео через протокол Model Context.

Создавайте, редактируйте, проверяйте, просматривайте и визуализируйте сохраненные проекты Shotcut через своего помощника ИИ. Результат остается редактируемой временной линией с транзакционными записями, которые защищают проект по мере его работы.

Демонстрация · Быстрый старт · Документация · Сайт

Демонстрация

Короткий экспорт H.264, созданный из родной временной шкалы Shotcut, отредактированной через Shotcut MCP.

[[Т1]]

Быстрый старт

Вам нужны Python 3.10+, Shotcut (рекомендуется 26.8.1, в комплекте MLT 7.41.0) и клиент MCP, который поддерживает локальные серверы stdio. Shotcut включает в себя необходимые средства массовой информации, кодеки и фильтры. Никаких дополнительных пакетов Python не требуется.

###1 Подключить клиента

| Клиент | Установка [править править код] | Claude Desktop / MCPB-совместимый клиент | Следуйте инструкциям по установке и обновлению MCPB. | Codex | Клонировать репозиторий и регистрировать локальный сервер. Клянусь Аллахом, он – поэт, как и говорят курайшиты! Подробности и ручная настройка

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Shotcut MCP

Local video editing through the Model Context Protocol.

Create, edit, validate, preview, and render saved Shotcut projects through your AI assistant. The result stays an editable .mlt timeline, with transactional writes that protect the project as you work.

Demonstration · Quick start · Documentation · Website

Demonstration

A short H.264 export created from a native Shotcut timeline edited through Shotcut MCP.

https://github.com/user-attachments/assets/c70f064f-17e7-403d-9bcf-689a9c616cdf

Quick start

You need Python 3.10+, Shotcut (recommended 26.8.1, bundled MLT 7.41.0), and an MCP client that supports local stdio servers. Shotcut includes the required media tools, codecs, and filters. No additional Python packages are required.

1. Connect your client

Client Installation
Claude Desktop / MCPB-compatible client Follow the MCPB installation and update guide.
Codex Clone the repository and register the local server.
Claude Code Run /plugin marketplace add matrodrigs/shotcut-mcp, then /plugin install shotcut-mcp@matrodrigs and /reload-plugins. Details and manual setup.
Other MCP client Configure a local stdio server.

The installation guide includes commands for Windows, macOS, and Linux. No pip install is required to run the server. For a source checkout, the guide also shows how to check Python and Shotcut with scripts/shotcut_mcp_server.py --check before connecting MCP.

2. Check readiness

Ask your assistant:

Run shotcut_status and shotcut_doctor. Report tool paths, versions, and failed runtime checks.

Resolve failed runtime checks before editing. See troubleshooting for recovery steps.

3. Make your first edit

Provide the source folder and the destination for the saved project, then describe your edit:

Create a 1920×1080, 30 fps Shotcut project from every video in this folder.
Put narration on A1, add 12-frame crossfades, and save it as documentary.mlt.
Generate a contact sheet so I can review the edit before exporting.

You can request adjustments in ordinary language. See the editing workflow and example prompts for subtitles, quality analysis, effects, and delivery.

Features

  • Edit the timeline: work with tracks, clips, transitions, speed changes, titles, and subtitles; discover source media in a folder and apply up to 500 operations in one transaction.
Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →