MCP Server: Kdenlive

Ein Python-MCP-Server, der es einem KI-Agenten ermöglicht, professionelle Videobearbeitung in Kdenlive durch natürliche Sprachbefehle durchzuführen.

Dies ist kein dünner Wrapper um ein paar Kdenlive-Befehle. Es ist ein mehrschichtiges System:

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

Die KI bearbeitet niemals direkt .kdenlive-XML. Sie ruft typisierte MCP-Tools auf, die ein sauberes, testbares internes Timeline-Modell verändern; ein dedizierter Adapter übersetzt dieses Modell beim Speichern in ein echtes Kdenlive-Projekt.

Status

Aktiv in Entwicklung, aufgebaut in Phasen (siehe PHASES unten). Das Kern-Timeline-Modell, der Kdenlive-XML-Adapter, der Effekte/Übergänge-Katalog und die Audio/Beat-Sync-Engine sind implementiert und gegen eine echte Kdenlive-26.04.3- und MLT-Installation getestet. Die MCP-Tool-Schicht, die all dies einem KI-Agenten zugänglich macht, wird als Nächstes verdrahtet.

Related MCP server: opencut-mcp

Warum dies auf dem realen Dateiformat basiert

Die vom Adapter (src/kdenlive_mcp/kdenlive/adapter/) verwendete Kdenlive-Projekt-XML-Struktur wurde aus echten .kdenlive-Projekten rückentwickelt und gegen eine lokal installierte Kdenlive 26.04.3 + MLT 7.38 (melt) geprüft, statt aus Dokumentation geraten zu werden. Die Kataloge für Effekte und Übergänge werden direkt aus Kdenlives eigenen mitgelieferten Effekt-/Übergangs-XML-Definitionen geparst, sodass die KI niemals einen Effekt referenzieren kann, der in der installierten Kdenlive nicht existiert.

Projektstruktur

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/

Entwicklung

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

Erfordert ffmpeg/ffprobe im PATH. Kdenlive/melt sind optional, ermöglichen jedoch die Effekt-/Übergangskataloge und die strukturelle Projektvalidierung gegen die echte Installation.