DaVinci Resolve MCP 서버

MCP 클라이언트가 도구와 리소스를 통해 DaVinci Resolve(Fusion 포함)를 제어하고 검사할 수 있게 해주는 Model Context Protocol(MCP) 서버입니다.

제공 기능

• 프로젝트 관리 (생성, 로드, 저장)

• 타임라인 작업 (타임라인 생성, 타임라인 전환, 클립으로 구성)

• 미디어 풀 작업 (미디어 가져오기, 폴더 생성, 폴더 검사)

• Fusion 도우미 (클립에 컴포지션 추가, 노드 생성, 노드 체인 생성)

• Resolve 페이지 탐색

• 고급 스크립팅 (execute_python, execute_lua)

Related MCP server: DaVinci MCP Professional

요구 사항

• Python 3.10 이상

• 스크립팅 API가 활성화된 DaVinci Resolve

• MCP 호환 클라이언트 (예: Claude Desktop)

설치

git clone https://github.com/apvlv/davinci-resolve-mcp.git
cd davinci-resolve-mcp
uv sync --all-extras --dev

서버 실행

uv run davinci-resolve-mcp

서버는 시작 시 Resolve에 연결을 시도합니다. DaVinci Resolve가 실행 중인지 확인하십시오.

MCP 클라이언트 설정

MCP 클라이언트가 서버 명령을 실행하도록 구성하십시오:

{
  "mcpServers": {
    "davinci-resolve": {
      "command": "uv",
      "args": ["run", "davinci-resolve-mcp"]
    }
  }
}

리소스

• system://status

• project://current

• project://timelines

• timeline://current

• mediapool://folders

• mediapool://current

• storage://volumes

도구

프로젝트

• create_project(name)

• load_project(name)

• save_project()

타임라인

• create_timeline(name)

• set_current_timeline(index)

미디어

• import_media(file_paths)

• create_folder(name)

• create_timeline_from_clips(name, clip_indices)

Fusion

• add_fusion_comp_to_clip(timeline_index, track_type, track_index, item_index)

• create_fusion_node(node_type, parameters)

• create_fusion_node_chain(node_chain)

Resolve UI

• open_page(page_name) (페이지 이름은 다음 중 하나여야 합니다:

  • media, edit, fusion, color, fairlight, deliver)

고급

• execute_python(code)

• execute_lua(script)

개발

make install      # install deps and pre-commit hooks
make lint-check   # ruff check
make format-check # ruff format check
make test         # pytest with coverage
make check        # lint + format + tests

사용 예시 아이디어

• "My Documentary라는 이름의 프로젝트를 생성해줘"

• "현재 프로젝트의 타임라인 목록을 보여줘"

• "이 파일들을 미디어 풀로 가져와줘"

• "Color 페이지를 열어줘"

• "Blur -> ColorCorrector로 이어지는 Fusion 노드 체인을 만들어줘"

라이선스

MIT (LICENSE 참조)