MCP Server: Kdenlive

Un servidor MCP de Python que permite a un agente de IA realizar edición de vídeo profesional en Kdenlive mediante instrucciones en lenguaje natural.

No es un envoltorio fino alrededor de un puñado de comandos de Kdenlive. Es un sistema en capas:

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

La IA nunca edita XML .kdenlive directamente. Llama a herramientas MCP tipadas que mutan un modelo de línea de tiempo interno limpio y comprobable; un adaptador dedicado traduce ese modelo a un proyecto real de Kdenlive al guardar.

Estado

En desarrollo activo, construido por fases (ver PHASES abajo). El modelo central de la línea de tiempo, el adaptador XML de Kdenlive, el catálogo de efectos/transiciones y el motor de sincronización de audio/ritmo están implementados y probados contra una instalación real de Kdenlive 26.04.3 + MLT. La capa orientada a herramientas MCP que expone todo esto a un agente de IA se está conectando a continuación.

Related MCP server: opencut-mcp

Por qué esto se basa en el formato de archivo real

La estructura XML del proyecto Kdenlive utilizada por el adaptador (src/kdenlive_mcp/kdenlive/adapter/) se obtuvo mediante ingeniería inversa a partir de proyectos .kdenlive reales y se contrastó con una instalación local de Kdenlive 26.04.3 + MLT 7.38 (melt), en lugar de deducirse de la documentación. Los catálogos de efectos y transiciones se analizan directamente de las definiciones XML de efectos/transiciones que incluye el propio Kdenlive, por lo que la IA nunca puede hacer referencia a un efecto que no exista realmente en la instalación de Kdenlive.

Estructura del proyecto

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/

Desarrollo

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

Requiere ffmpeg/ffprobe en el PATH. Kdenlive/melt son opcionales, pero desbloquean los catálogos de efectos/transiciones y la validación estructural del proyecto contra la instalación real.