MCP Server: Kdenlive

Python MCP сервер, который позволяет ИИ-агенту выполнять профессиональный видеомонтаж в Kdenlive с помощью инструкций на естественном языке.

Это не тонкая обёртка над несколькими командами Kdenlive. Это многоуровневая система:

AI Agent (Claude)
  -> MCP tools (project/media/timeline/motion/effects/audio/...)
  -> Video analysis layer (ffprobe, librosa)
  -> Internal timeline model (Project / Sequence / Track / Clip / Keyframe)
  -> Kdenlive adapter (translates the model to/from real .kdenlive XML)
  -> .kdenlive project file
  -> Kdenlive / FFmpeg / MLT (melt) rendering

ИИ никогда не редактирует XML .kdenlive напрямую. Он вызывает типизированные MCP-инструменты, которые изменяют чистую, тестируемую внутреннюю модель таймлайна; специальный адаптер преобразует эту модель в реальный проект Kdenlive при сохранении.

Статус

Активно разрабатывается, создаётся поэтапно (см. PHASES ниже). Базовая модель таймлайна, адаптер XML Kdenlive, каталог эффектов/переходов и движок аудио/синхронизации по битам реализованы и протестированы с реальной установкой Kdenlive 26.04.3 + MLT. Следующим этапом подключается слой, ориентированный на MCP-инструменты, который предоставляет всё это ИИ-агенту.

Related MCP server: opencut-mcp

Почему это основано на реальном формате файлов

Структура XML проекта Kdenlive, используемая адаптером (src/kdenlive_mcp/kdenlive/adapter/), была восстановлена из реальных проектов .kdenlive и перепроверена с локально установленным Kdenlive 26.04.3 + MLT 7.38 (melt), а не угадана из документации. Каталоги эффектов и переходов напрямую парсятся из собственных XML-определений эффектов/переходов, поставляемых с Kdenlive, поэтому ИИ никогда не сможет сослаться на эффект, которого на самом деле нет в установленном Kdenlive.

Структура проекта

src/kdenlive_mcp/
  core/           # internal model: timeline, keyframes, effects, transitions, audio, assets
  kdenlive/       # the adapter: XML read/write, effect & transition catalogs, capability detection
  media/          # ffmpeg/ffprobe subprocess wrappers, thumbnail generation
  storage/        # workspace path safety, caching, snapshots
  validation/     # project validation
  mcp_tools/      # MCP-facing tool definitions (in progress)
tests/

Разработка

python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
pytest

Требуется ffmpeg/ffprobe в PATH. Kdenlive/melt необязательны, но открывают доступ к каталогам эффектов/переходов и структурной проверке проекта относительно реальной установки.