Skip to main content
Glama

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) rendering

AI는 .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]"
pytest

PATH에 ffmpeg/ffprobe가 필요합니다. Kdenlive/melt는 선택 사항이지만 실제 설치 환경에 대한 효과/전환 카탈로그와 구조적 프로젝트 검증을 활성화합니다.

Related MCP Connectors

Related MCP Servers