samuelgursky/davinci-resolve-mcp

이것이 무엇인가

davinci-resolve-mcp 는 AI 어시스턴트(예: Claude)가 전문 비디오 편집 및 색보정 애플리케이션인 DaVinci Resolve 를 직접 제어할 수 있게 해주는 브리지입니다. 이는 Model Context Protocol (MCP) — AI 도구가 외부 소프트웨어에 연결하는 표준 방식 — 을 구현하여 AI가 실제 편집 작업(프로젝트 열기, 타임라인 구축, 클립 추가, 색상 조정, 렌더 설정 등)을 수행할 수 있게 합니다.

작동 방식

DaVinci Resolve에는 외부 프로그램이 제어할 수 있는 공식 스크립팅 API 가 포함되어 있습니다. 이 프로젝트는 해당 API를 AI 어시스턴트가 호출할 수 있는 MCP "도구"로 래핑합니다. "현재 빈의 모든 클립으로 'Assembly Cut'이라는 타임라인을 만들어"라고 AI에 요청하면, AI는 이 서버를 통해 일련의 API 호출로 변환합니다.

두 가지 모드로 제공됩니다:

• 복합 모드 (기본값): 관련 작업을 그룹화한 37개의 도구로 AI 컨텍스트 사용량을 낮게 유지
• 전체/세분화 모드: Resolve API 메서드당 하나씩, 390개의 도구로 고급 사용자용

또한 고급 오프라인 서버 (Node.js)가 있으며, Resolve가 실행되지 않아도 작동합니다 — Resolve 프로젝트 파일(.drp, .drt, .drx)을 직접 읽고 편집하여 클라우드 기반 그레이딩, QC, 파이프라인 자동화를 가능하게 합니다.

주요 기능

• 전체 편집 제어: 미디어 풀 관리, 타임라인 편집, 색보정, Fusion 합성, 오디오/Fairlight, 렌더 설정, 리뷰 마커
• 미디어 분석: 동기화 이벤트(2-pop, 슬레이트 클랩) 감지, 클립 분석, 메타데이터를 Resolve에 다시 작성
• 안전 엔벨로프: 모든 도구는 상태, 검증(읽기 백이 변경을 확인했는지?), 의미적 델타를 포함한 구조화된 결과를 반환 — AI 에이전트는 작업이 실제로 성공했는지 알 수 있습니다
• 실행 추적: 다단계 AI 작업은 통합 추적으로 기록되어 편집자가 AI가 왜 그런 작업을 했는지 감사할 수 있습니다
• 무료 버전 지원: Blackmagic은 외부 스크립팅을 유료 Studio 버전으로 제한하지만, 이 프로젝트에는 무료 버전(Resolve 21.0.x)에서 이를 우회하는 앱 내 브리지 스크립트가 포함되어 있습니다
• 로컬 제어 패널: Resolve 상태 및 분석 결과를 검사하기 위한 브라우저 기반 UI
• 클라이언트 지원: Claude Desktop, Cursor, VS Code, Windsurf, Zed 및 기타 많은 AI 코딩 도구를 자동 구성합니다

왜 중요한가

이것은 AI 에이전트가 전문 창의 소프트웨어를 운영하는 실용적인 예입니다 — 단순히 채팅하는 것이 아니라, 실수가 비용이 많이 드는 도구에서 실제 작업을 수행합니다. 검증, 감사 추적, 보호된 작업(파괴적 작업 전 확인)에 대한 강조는 에이전트 AI가 프로덕션 환경에서 안전하게 만들어질 수 있는 방법을 보여줍니다. 오프라인 파일 수준 서버는 데스크톱 앱을 실행하지 않고 AI 파이프라인이 클라우드에서 어떻게 작동할 수 있는지도 보여줍니다.