MCP Server: Kdenlive

AIエージェントが自然言語の指示を通じてKdenliveでプロフェッショナルなビデオ編集を実行できるようにするPython製MCPサーバーです。

これは、いくつかの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

AIは.kdenlive XMLを直接編集することはありません。型付きMCPツールを呼び出して、クリーンでテスト可能な内部タイムラインモデルを変更します。専用アダプターが保存時にそのモデルを実際のKdenliveプロジェクトに変換します。

ステータス

活発に開発中で、フェーズごとに構築されています（下記のPHASESを参照）。コアのタイムラインモデル、Kdenlive XMLアダプター、エフェクト/トランジションカタログ、オーディオ/ビート同期エンジンは実装され、実際のKdenlive 26.04.3 + MLTインストール環境に対してテストされています。これらすべてをAIエージェントに公開するMCPツール層は、次に接続されています。

Related MCP server: opencut-mcp

なぜ実ファイル形式に基づいているのか

アダプター（src/kdenlive_mcp/kdenlive/adapter/）が使用するKdenliveプロジェクトXML構造は、実際の.kdenliveプロジェクトからリバースエンジニアリングされ、ローカルにインストールされたKdenlive 26.04.3 + MLT 7.38（melt）と照合されています。ドキュメントから推測したものではありません。エフェクトとトランジションのカタログは、Kdenlive自身が同梱するエフェクト/トランジションXML定義から直接解析されるため、AIがインストール済みの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はオプションですが、実際のインストール環境に対するエフェクト/トランジションカタログと構造的プロジェクト検証を有効にします。