DaVinci Resolve MCP 서버

AI 코딩 어시스턴트(Cursor, Claude Desktop)를 DaVinci Resolve에 연결하여 자연어로 DaVinci Resolve를 쿼리하고 제어할 수 있도록 하는 MCP(Model Context Protocol) 서버입니다.

특징

구현되고 계획된 기능의 포괄적인 목록은 docs/FEATURES.md를 참조하세요.

요구 사항

• DaVinci Resolve가 설치된 macOS 또는 Windows
• 파이썬 3.6 이상
• 백그라운드에서 실행되는 DaVinci Resolve
• (선택 사항) 일부 기능의 경우 Node.js/npm

설치 가이드

자세한 설치 지침은 INSTALL.md를 참조하세요. 이 가이드에서는 다음 내용을 다룹니다.

• 필수 구성 요소 및 시스템 요구 사항
• 단계별 설치 프로세스
• 구성 세부 정보
• 일반적인 문제 해결 단계

플랫폼 지원

빠른 시작 가이드

새로운 원스텝 설치(권장)

가장 쉬운 시작 방법은 새로운 통합 설치 스크립트를 사용하는 것입니다. 이 스크립트는 모든 작업을 자동으로 처리합니다.

• 저장소를 복제합니다.지엑스피1
• DaVinci Resolve Studio가 설치되어 실행 중인지 확인하세요.
• 설치 스크립트를 실행합니다: macOS/Linux:
  ./install.sh
  윈도우:
  install.bat

이렇게 하면:

1. 시스템에서 올바른 경로를 자동으로 감지합니다.
2. Python 가상 환경 만들기
3. 공식 저장소에서 MCP SDK를 설치하세요
4. 환경 변수 설정
5. Cursor/Claude 통합 구성
6. 설치가 올바른지 확인하세요
7. 선택적으로 MCP 서버를 시작합니다.

대체 빠른 시작

원래의 빠른 시작 스크립트를 사용할 수도 있습니다.

Windows 사용자:

macOS 사용자:

구성

Cursor나 Claude와 같은 다양한 AI 어시스턴트 클라이언트를 사용하여 DaVinci Resolve MCP를 구성하려면 config-templates 디렉토리를 참조하세요.

문제 해결

자세한 문제 해결 지침은 일반적인 문제에 대한 솔루션이 포함된 INSTALL.md 파일을 참조하세요.

일반적인 문제

경로 해결

• 설치 스크립트는 이제 더욱 강력한 경로 분석을 사용하여 잘못된 위치에서 파일을 찾는 run-now.sh 문제를 해결합니다.
• 스크립트가 위치에 따라 올바른 경로를 결정하도록 항상 두십시오.

DaVinci Resolve 감지

• 프로세스 목록에 어떻게 나타나는지에 관계없이 DaVinci Resolve를 안정적으로 찾을 수 있도록 프로세스 감지 기능을 개선했습니다.
• MCP 서버를 시작하기 전에 DaVinci Resolve가 실행 중인지 확인하세요.

환경 변수

• 모든 필수 환경 변수가 올바르게 설정되었는지 확인하세요.
• 문제 해결을 위해 scripts/cursor_resolve_server.log 의 로그 파일을 검토하세요.

윈도우

• 구성 파일에서는 반드시 슬래시(/)를 사용하세요.
• Python을 설치하고 configs에서 경로를 구성해야 합니다.
• 서버를 시작하기 전에 DaVinci Resolve가 실행 중이어야 합니다.

맥OS

• 스크립트에 실행 권한이 있는지 확인하세요
• Python 관련 오류가 있는지 Console.app을 확인하세요.
• 환경 변수가 올바르게 설정되었는지 확인하세요
• 서버를 시작하기 전에 DaVinci Resolve가 실행 중이어야 합니다.

지원하다

문제 및 기능 요청은 GitHub 문제 추적기를 이용하세요.

실행 옵션

설치 후 서버를 시작하는 방법은 여러 가지가 있습니다.

클라이언트별 출시 스크립트

저장소에는 특정 클라이언트로 시작하기 위한 전용 스크립트가 포함되어 있습니다.

이러한 특수 스크립트:

• 각 클라이언트에 맞는 적절한 환경을 설정하세요
• DaVinci Resolve가 실행 중인지 확인하세요
• 클라이언트별 설정 구성
• 적절한 매개변수로 MCP 서버를 시작합니다.

출시 전 확인

AI 어시스턴트를 연결하기 전에 환경이 올바르게 구성되었는지 확인하세요.

이 스크립트는 다음을 수행합니다.

• DaVinci Resolve가 실행 중인지 확인하고 시작을 제안합니다.
• 환경 변수가 제대로 설정되었는지 확인하세요
• Python 환경이 올바르게 구성되었는지 확인하세요
• 커서/클로드 구성 검증
• 선택적으로 커서를 시작합니다

유니버설 런처

고급 사용자를 위해 통합 런처를 사용하면 Cursor와 Claude Desktop 서버를 완벽하게 제어할 수 있습니다.

추가 옵션:

• 강제 모드(Resolve 실행 확인 건너뛰기): --force
• 프로젝트 선택: --project "Project Name"

전체 설치

완전한 수동 설치의 경우:

1. 이 저장소를 복제하세요:
   git clone https://github.com/samuelgursky/davinci-resolve-mcp.git cd davinci-resolve-mcp
2. Python 가상 환경을 만듭니다.
   # Create virtual environment python -m venv venv # Activate it # On macOS/Linux: source venv/bin/activate # On Windows: venv\Scripts\activate # Install dependencies from requirements.txt pip install -r requirements.txt # Alternatively, install MCP SDK directly pip install git+https://github.com/modelcontextprotocol/python-sdk.git
3. DaVinci Resolve 스크립팅 환경 변수를 설정하세요.macOS의 경우 :
   export RESOLVE_SCRIPT_API="/Library/Application Support/Blackmagic Design/DaVinci Resolve/Developer/Scripting" export RESOLVE_SCRIPT_LIB="/Applications/DaVinci Resolve/DaVinci Resolve.app/Contents/Libraries/Fusion/fusionscript.so" export PYTHONPATH="$PYTHONPATH:$RESOLVE_SCRIPT_API/Modules/"
   Windows의 경우 :
   set RESOLVE_SCRIPT_API=C:\ProgramData\Blackmagic Design\DaVinci Resolve\Support\Developer\Scripting set RESOLVE_SCRIPT_LIB=C:\Program Files\Blackmagic Design\DaVinci Resolve\fusionscript.dll set PYTHONPATH=%PYTHONPATH%;%RESOLVE_SCRIPT_API%\Modules
   또는 사전 출시 확인 스크립트를 실행하면 다음 사항이 자동으로 설정됩니다.
   # On macOS ./scripts/check-resolve-ready.sh # On Windows ./scripts/check-resolve-ready.bat
4. 구성 파일을 만들어 서버를 사용하도록 Cursor를 구성합니다.macOS의 경우 ( ~/.cursor/mcp.json ):
   { "mcpServers": { "davinci-resolve": { "name": "DaVinci Resolve MCP", "command": "/path/to/your/venv/bin/python", "args": [ "/path/to/your/davinci-resolve-mcp/src/main.py" ] } } }
   Windows의 경우 ( %APPDATA%\Cursor\mcp.json ):
   { "mcpServers": { "davinci-resolve": { "name": "DaVinci Resolve MCP", "command": "C:\\path\\to\\venv\\Scripts\\python.exe", "args": ["C:\\path\\to\\davinci-resolve-mcp\\src\\main.py"] } } }
5. 클라이언트별 스크립트 중 하나를 사용하여 서버를 시작합니다.
   # For Cursor ./scripts/mcp_resolve-cursor_start # For Claude Desktop ./scripts/mcp_resolve-claude_start

AI 어시스턴트 사용

커서와 함께 사용

1. 전용 스크립트를 사용하여 커서 서버를 시작합니다.
   ./scripts/mcp_resolve-cursor_start
   또는 범용 런처를 사용하세요.
   ./scripts/mcp_resolve_launcher.sh --start-cursor
2. 커서를 시작하고 프로젝트를 엽니다.
3. 커서의 AI 채팅에서 이제 DaVinci Resolve와 상호 작용할 수 있습니다. 다음과 같은 명령을 사용해 보세요.
   • "현재 실행 중인 DaVinci Resolve 버전은 무엇입니까?"
   • "DaVinci Resolve의 모든 프로젝트 나열"
   • "'내 시퀀스'라는 새 타임라인을 만듭니다."
   • "현재 위치에 마커 추가"

Claude Desktop과 함께 사용

1. config-templates 디렉토리의 템플릿을 사용하여 Claude Desktop 구성 디렉토리에 claude_desktop_config.json 파일을 만듭니다.
2. 전용 스크립트를 사용하여 Claude Desktop 서버를 실행합니다.
   ./scripts/mcp_resolve-claude_start
   또는 범용 런처를 사용하세요.
   ./scripts/mcp_resolve_launcher.sh --start-claude
3. Claude Desktop에서는 이제 Cursor와 동일한 명령을 사용하여 DaVinci Resolve와 상호 작용할 수 있습니다.

사용 가능한 기능

일반적인

• DaVinci Resolve 버전을 받으세요
• 현재 페이지 가져오기/전환(편집, 색상, 퓨전 등)

프로젝트 관리

• 사용 가능한 프로젝트 나열
• 현재 프로젝트 이름 가져오기
• 이름으로 프로젝트 열기
• 새 프로젝트 만들기
• 현재 프로젝트 저장

타임라인 작업

• 모든 타임라인 나열
• 현재 타임라인 정보 가져오기
• 새로운 타임라인 만들기
• 이름으로 타임라인으로 전환
• 타임라인에 마커 추가

미디어 풀 운영

• 미디어 풀 클립 나열
• 미디어 파일 가져오기
• 미디어 빈 만들기
• 타임라인에 클립 추가

Windows 지원 참고 사항

Windows 지원은 v1.3.3에서 안정적이며 추가적인 문제 해결이 필요하지 않습니다.

• DaVinci Resolve가 기본 위치에 설치되어 있는지 확인하세요.
• 환경 변수는 위에서 설명한 대로 올바르게 설정되었습니다.
• Windows 경로는 설치에 따라 조정이 필요할 수 있습니다.
• 문제가 있는 경우, logs/ 디렉토리의 로그를 확인하세요.

문제 해결

DaVinci Resolve 연결

서버를 시작하기 전에 DaVinci Resolve가 실행 중인지 확인하세요. 서버가 Resolve에 연결할 수 없는 경우 다음 사항을 확인하세요.

1. 환경 변수가 올바르게 설정되었습니다.
2. DaVinci Resolve 설치를 위한 올바른 경로가 있습니다.
3. 환경 변수를 설정한 후 터미널을 다시 시작했습니다.

프로젝트 구조

특허

MIT

감사의 말

• DaVinci Resolve 및 해당 API를 위한 Blackmagic Design
• AI 어시스턴트 통합을 가능하게 하는 MCP 프로토콜 팀

작가

사무엘 거스키( samgursky@gmail.com )

• GitHub: github.com/samuelgursky

미래 계획

• Windows 및 Linux 지원
• 추가 DaVinci Resolve 기능
• Claude Desktop 지원

개발

기여하고 싶으시다면 저장소의 기능 체크리스트를 확인하고 아직 구현되지 않은 기능을 선택해 주세요. 코드는 기능 영역별로 명확한 섹션으로 구성되어 있습니다.

특허

MIT

감사의 말

• DaVinci Resolve 및 해당 API를 위한 Blackmagic Design
• AI 어시스턴트 통합을 가능하게 하는 MCP 프로토콜 팀

프로젝트 구조

정리 후 프로젝트 구조는 다음과 같습니다.

• resolve_mcp_server.py - 주요 MCP 서버 구현
• run-now.sh - 설정을 처리하고 서버를 실행하는 빠른 시작 스크립트
• setup.sh - 설치를 위한 완전한 설정 스크립트
• check-resolve-ready.sh - DaVinci Resolve가 준비되었는지 확인하기 위한 사전 실행 확인
• start-server.sh - 서버를 시작하는 스크립트
• run-server.sh - 서버를 직접 실행하기 위한 단순화된 스크립트

주요 디렉토리:

• src/ - 소스 코드 및 모듈
• assets/ - 프로젝트 자산 및 리소스
• logs/ - 로그 파일 디렉토리
• scripts/ - 도우미 스크립트

개발할 때는 ./run-now.sh 사용하는 것이 좋습니다. 이 명령어는 환경을 설정하고 한 단계로 서버를 시작합니다.

변경 사항

자세한 변경 내역은 docs/CHANGELOG.md 에서 확인하세요.

커서별 설정

Cursor와 통합할 때는 다음의 구체적인 단계를 따르세요.

1. 커서를 시작하기 전에 DaVinci Resolve가 실행 중인지 확인하세요.
2. 필요한 종속성을 설치하세요:
   # From the davinci-resolve-mcp directory: pip install -r requirements.txt
   참고: 이렇게 하면 MCP 패키지와 기타 종속성이 자동으로 설치됩니다.
3. Cursor에서 MCP 서버 구성을 설정합니다.macOS에서는 ~/.cursor/mcp.json (Windows에서는 %USERPROFILE%\.cursor\mcp.json )을 만들거나 편집합니다.
   { "mcpServers": { "davinci-resolve": { "name": "DaVinci Resolve MCP", "command": "/path/to/your/venv/bin/python", "args": [ "/path/to/your/davinci-resolve-mcp/src/main.py" ] } } }
   중요 참고 사항:
   • main.py 진입점으로 사용하세요( resolve_mcp_server.py 가 아님)
   • 구성에서 절대 경로를 사용하세요
4. 일반적인 문제:
   • "클라이언트 닫힘" 오류: mcp.json의 경로가 올바르고 종속성이 설치되어 있는지 확인하세요.
   • 연결 문제: Cursor를 시작하기 전에 DaVinci Resolve가 실행 중인지 확인하세요.
   • 환경 변수: main.py 스크립트는 환경 변수 설정을 처리합니다.