DaVinci Resolve MCP 서버

DaVinci Resolve 및 Fusion과 상호 작용하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 Claude와 같은 AI 비서가 모델 컨텍스트 프로토콜을 통해 DaVinci Resolve와 직접 상호 작용하고 제어할 수 있습니다.

특징

• 양방향 통신: MCP 프로토콜을 통해 Claude AI를 DaVinci Resolve에 연결합니다.
• 프로젝트 관리: DaVinci Resolve 프로젝트 생성, 열기 및 관리
• 타임라인 조작: 타임라인 생성, 수정 및 탐색
• 미디어 관리: 미디어 풀에서 미디어 가져오기, 구성 및 관리
• Fusion 통합: Fusion 구성 생성 및 수정
• 현장 검사: 현재 DaVinci Resolve 프로젝트에 대한 자세한 정보를 얻으세요
• 코드 실행: Claude에서 DaVinci Resolve에서 임의의 Python 코드 실행

설치

필수 조건

• DaVinci Resolve Studio(버전 17 이상 권장)
• Python 3.8 이상
• Claude Desktop(AI 통합용)

설정

1. 이 저장소를 복제하세요:지엑스피1
2. 필요한 종속성을 설치하세요:
   pip install -r requirements.txt
3. Claude Desktop에 MCP 서버를 설치하세요:
   mcp install src/resolve_mcp/server.py
   또는 개발을 위해 편집 가능한 플래그를 사용하여 설치할 수 있습니다.
   mcp install src/resolve_mcp/server.py --with-editable .

용법

클로드 데스크톱과 함께

1. DaVinci Resolve 시작
2. Claude Desktop에서 "DaVinci Resolve MCP" 서버에 연결합니다.
3. 이제 Claude를 통해 DaVinci Resolve와 상호 작용할 수 있습니다.

5ire와 함께

5ire 는 이 서버와 호환되는 오픈 소스 크로스 플랫폼 데스크톱 AI 어시스턴트이자 MCP 클라이언트입니다.

1. GitHub 에서 5ire를 설치하거나 macOS에서 Homebrew를 사용하세요.
   brew tap brewforge/extras brew install --cask 5ire
2. DaVinci Resolve 시작
3. 5ire에서 DaVinci Resolve MCP 서버를 추가합니다.
4. 선호하는 AI 모델(OpenAI, Claude 등)을 사용하여 서버에 연결합니다.
5. 이제 5ire를 통해 DaVinci Resolve와 상호 작용할 수 있습니다.

사용 가능한 명령

리소스(정보 검색)

• project://current - 현재 프로젝트에 대한 정보를 가져옵니다.
• project://timelines - 현재 프로젝트의 타임라인 목록을 가져옵니다.
• timeline://current - 현재 타임라인에 대한 정보를 가져옵니다.
• mediapool://folders - 미디어 풀에 있는 폴더 목록을 가져옵니다.
• mediapool://current - 현재 미디어 풀 폴더에 대한 정보를 가져옵니다.
• storage://volumes - 미디어 저장소에 마운트된 볼륨 목록을 가져옵니다.
• system://status - DaVinci Resolve 연결의 현재 상태를 가져옵니다.

프로젝트 관리

• create_project(name) - 새로운 DaVinci Resolve 프로젝트를 만듭니다.
• load_project(name) - 기존 DaVinci Resolve 프로젝트를 로드합니다.
• save_project() - 현재 DaVinci Resolve 프로젝트를 저장합니다.

타임라인 관리

• create_timeline(name) - 현재 프로젝트에 새 타임라인을 만듭니다.
• set_current_timeline(index) - 인덱스(1부터 시작)로 현재 타임라인을 설정합니다.

미디어 관리

• import_media(file_paths) - 미디어 파일을 현재 미디어 풀 폴더로 가져옵니다.
• create_folder(name) - 현재 미디어 풀 폴더에 새 폴더를 만듭니다.
• create_timeline_from_clips(name, clip_indices) - 현재 미디어 풀 폴더의 클립에서 새 타임라인을 만듭니다.

퓨전 통합

• add_fusion_comp_to_clip(timeline_index, track_type, track_index, item_index) - 타임라인의 클립에 Fusion 구성을 추가합니다.
• create_fusion_node(node_type, parameters) - 현재 구성에서 특정 Fusion 노드를 생성합니다.
• create_fusion_node_chain(node_chain) - 현재 구성에서 연결된 Fusion 노드 체인을 생성합니다.

페이지 탐색

• open_page(page_name) - DaVinci Resolve에서 특정 페이지 열기(미디어, 편집, 퓨전, 색상, 페어라이트, 전달)

고급 작업

• execute_python(code) - DaVinci Resolve에서 임의의 Python 코드 실행
• execute_lua(script) - DaVinci Resolve의 Fusion에서 Lua 스크립트를 실행합니다.

예시

• "'내 다큐멘터리'라는 이름의 새 프로젝트를 만드세요"
• "다운로드 폴더에서 모든 비디오 파일을 가져옵니다"
• "선택한 클립으로 새 타임라인을 만듭니다"
• "선택한 클립에 퓨전 효과 적용"
• "현재 프로젝트에 대한 정보를 얻으세요"
• "색상 페이지로 전환"
• "현재 프로젝트 저장"
• "미디어 풀에 'Raw Footage'라는 이름의 폴더를 만듭니다."
• "현재 Fusion 구성에 Blur 노드를 만듭니다"
• "Hello World"라는 내용의 텍스트 노드를 만듭니다.
• "노드 체인을 만듭니다: MediaIn -> Blur -> ColorCorrector -> MediaOut"

기술적 세부 사항

서버는 모델 컨텍스트 프로토콜(Model Context Protocol)을 사용하여 Claude와 DaVinci Resolve 간의 통신을 수행합니다. 또한 DaVinci Resolve의 Python API를 활용하여 애플리케이션을 제어합니다.

특허

MIT