kdenlive-mcp-server
MCP 서버: 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) renderingAI는 .kdenlive XML을 직접 편집하지 않습니다. AI는 깨끗하고 테스트 가능한 내부 타임라인 모델을 변경하는 타입화된 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]"
pytestPATH에 ffmpeg/ffprobe가 필요합니다. Kdenlive/melt는 선택 사항이지만 실제 설치 환경에 대한 효과/전환 카탈로그와 구조적 프로젝트 검증을 활성화합니다.
This server cannot be deployed
Maintenance
Related MCP Connectors
AI video editor for agents and humans: timeline, captions, color, audio and generation as MCP tools.
MCP server for Clipkit — gives AI agents a video toolbox via the Clipkit schema.
Autonomous AI video editor over MCP: viral clips, captions, reframe, chroma key, MP4 export
Agentic AI video editor: edit a real timeline, generate clips, music and voice, then render.
Related MCP Servers
- AlicenseAqualityCmaintenanceAn MCP server that lets AI agents visually perceive and edit video inside DaVinci Resolve Studio by rendering frames and manipulating the timeline.21MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that enables LLM agents to control the OpenCut classic video editor's timeline through a Playwright-controlled browser, allowing automated video editing tasks like adding media, inserting clips, splitting, trimming, and exporting.7MIT
- FlicenseNot gradedqualityBmaintenanceMCP server for DaVinci Resolve video editing, enabling AI agents to execute editing operations, manage creative libraries, and analyze media content.-
- AlicenseNot gradedqualityCmaintenanceA real video editor for AI agents, served over MCP, enabling journaled timeline editing, rendering via FFmpeg/MLT, and deterministic CLI operation.1MIT