io.github.Airta-Admin/davinc-resolve-local-bridge-mcp
Davinc-Resolve-Local-Bridge-MCP
이게 뭔가요?
Davinc-Resolve-Local-Bridge-MCP는 AI 어시스턴트에게 DaVinci Resolve를 완전히 제어할 수 있는 기능을 제공하는 Model Context Protocol (MCP) 서버입니다. 프로젝트, 타임라인, 미디어, Fusion, 컬러 그레이딩, 렌더링 등 Resolve 스크립팅 API 전체를 포괄하는 215개 도구를 제공합니다.
작동 방식
Your AI Assistant (Claude, Cursor, Devin, etc.)
│
│ talks MCP (stdio)
▼
mcp_server/server.py ← runs on your machine
│
│ talks HTTP (localhost:8787)
▼
Bridge-Connection-Script.py ← runs INSIDE DaVinci Resolve
│ (Workspace > Scripts menu)
▼
DaVinci Resolve API ← full read + write access브리지 스크립트는 DaVinci Resolve 프로세스 내부에서 실행되어 Resolve 스크립팅 API에 완전히 접근할 수 있습니다 — 외부 스크립팅을 차단하는 Free 에디션에서도 가능합니다. MCP 서버는 별도 프로세스로 실행되며 localhost HTTP를 통해 브리지에 도구 호출을 프록시합니다.
Related MCP server: resolve-mcp
빠른 시작
사전 요구 사항
DaVinci Resolve 18.5+ (Free 또는 Studio)
컴퓨터에 설치된 Python 3.10+
MCP 호환 AI 어시스턴트 (Claude Desktop, Cursor, Devin 등)
1단계 — 브리지 스크립트 설치
설치 프로그램 실행:
python install.py또는 bridge/Bridge-Connection-Script.py를 Resolve의 스크립트 폴더에 수동으로 복사:
플랫폼 | 경로 |
Windows |
|
macOS |
|
Linux |
|
2단계 — MCP 서버 의존성 설치
pip install -r requirements.txt3단계 — AI 어시스턴트 구성
어시스턴트의 구성 파일에 MCP 서버를 추가하세요. 서버 경로는 이 저장소의 mcp_server/server.py입니다.
Claude Desktop
claude_desktop_config.json 편집:
{
"mcpServers": {
"davinci-resolve-local-bridge": {
"command": "python",
"args": ["C:/path/to/Davinc-Resolve-Local-Bridge-MCP/mcp_server/server.py"]
}
}
}Cursor
.cursor/mcp.json 편집:
{
"mcpServers": {
"davinci-resolve-local-bridge": {
"command": "python",
"args": ["C:/path/to/Davinc-Resolve-Local-Bridge-MCP/mcp_server/server.py"]
}
}
}Devin
mcp_config.json 편집:
{
"mcpServers": {
"resolve-local-bridge": {
"command": "python",
"args": ["C:/path/to/Davinc-Resolve-Local-Bridge-MCP/mcp_server/server.py"]
}
}
}Claude Code
claude mcp add davinci-resolve-local-bridge -- python C:/path/to/Davinc-Resolve-Local-Bridge-MCP/mcp_server/server.py모든 MCP 클라이언트 (일반)
서버는 stdio 전송을 사용합니다. 다음과 같이 실행하세요:
python mcp_server/server.py4단계 — DaVinci Resolve 내부에서 브리지 시작
DaVinci Resolve를 엽니다
Workspace → Scripts → Bridge-Connection-Script로 이동
Console (Workspace → Console)에서 다음을 확인:
[Resolve Bridge] Connected to Resolve 21.0.4.5
[Resolve Bridge] HTTP server running on http://127.0.0.1:8787
[Resolve Bridge] 215 actions available5단계 — 사용 시작
AI 어시스턴트에게 물어보세요:
"DaVinci Resolve가 연결되어 있는지 확인해줘"
어시스턴트가 resolve_status 도구를 호출하고 결과를 보고합니다. 그런 다음 시도해 보세요:
"'My Video'라는 이름의 1920x1080 30fps 새 프로젝트를 만들고 타임라인을 추가해줘"
아키텍처
브리지 스크립트 (bridge/Bridge-Connection-Script.py)
Workspace > Scripts 메뉴를 통해 DaVinci Resolve 내부에서 실행되는 Python 스크립트입니다. 다음을 수행합니다:
Fusion의 전역 변수에서 라이브
resolve객체를 가져옴127.0.0.1:8787에서 HTTP 서버 시작3개의 엔드포인트 제공:
GET /health— 브리지가 살아있는지 확인GET /actions— 사용 가능한 모든 액션 이름 나열POST /action— 이름과 매개변수로 액션 실행
차단형
serve_forever()호출로 유지시작 전에 같은 포트의 이전 인스턴스를 종료
MCP 서버 (mcp_server/server.py)
다음을 수행하는 독립형 MCP 서버:
localhost에서 HTTP로 브리지에 연결
브리지의
/actions엔드포인트에서 215개 액션을 자동으로 발견각 액션을
resolve_접두사가 붙은 MCP 도구로 노출POST /action을 통해 브리지에 도구 호출을 프록시브리지와 동기화 유지 — 수동 도구 정의 불필요
전체 215개 도구
MCP 서버는 브리지에서 도구를 자동으로 발견합니다. 각 도구에는 resolve_ 접두사가 붙습니다 (예: status는 resolve_status가 됨). 매개변수는 params 객체로 전달하세요.
Resolve 애플리케이션 (15개 도구)
도구 | 매개변수 | 설명 |
| — | 브리지 연결 확인 및 현재 프로젝트/타임라인 정보 가져오기 |
| — | Resolve 버전 정보 가져오기 |
| — | 활성 페이지 가져오기 (edit, cut, color 등) |
|
| 페이지 전환: edit, cut, fusion, color, fairlight, deliver, media |
| — | 사용 가능한 레이아웃 프리셋 나열 |
|
| 이름으로 레이아웃 프리셋 로드 |
| — | 현재 키프레임 모드 가져오기 |
|
| 키프레임 모드 설정 |
| — | Fairlight 오디오 프리셋 나열 |
| — | 번인 프리셋 나열 |
|
| 파일에서 렌더 프리셋 가져오기 |
|
| 렌더 프리셋을 파일로 내보내기 |
| — | Fusion 페이지로 전환 |
| — | Edit 페이지로 전환 |
| — | Deliver 페이지로 전환 |
프로젝트 매니저 (18개 도구)
도구 | 매개변수 | 설명 |
|
| 새 프로젝트 생성 |
|
| 기존 프로젝트 로드 |
| — | 현재 프로젝트 저장 |
| — | 현재 프로젝트 닫기 |
|
| 프로젝트 삭제 |
|
| 프로젝트 폴더 생성 |
|
| 프로젝트 폴더 삭제 |
| — | 현재 폴더의 프로젝트 나열 |
| — | 현재 폴더의 하위 폴더 나열 |
| — | 현재 폴더 이름 가져오기 |
|
| 폴더 열기 |
| — | 루트 폴더로 이동 |
| — | 상위 폴더로 이동 |
|
| .drp 프로젝트 가져오기 |
|
| 프로젝트를 .drp로 내보내기 |
|
| 프로젝트 보관 |
| — | 현재 데이터베이스 이름 가져오기 |
| — | 사용 가능한 데이터베이스 나열 |
프로젝트 설정 (7개 도구)
도구 | 매개변수 | 설명 |
| — | 현재 프로젝트 이름 가져오기 |
|
| 현재 프로젝트 이름 변경 |
|
| 키로 프로젝트 설정 가져오기 |
|
| 프로젝트 설정 지정 |
| — | 모든 프로젝트 설정 가져오기 |
| — | 프로젝트 프리셋 나열 |
|
| 프로젝트 프리셋 적용 |
미디어 저장소 (4개 도구)
도구 | 매개변수 | 설명 |
| — | 마운트된 저장소 볼륨 나열 |
|
| 경로의 하위 폴더 나열 |
|
| 폴더의 파일 나열 |
|
| OS 파일 브라우저에서 파일 표시 |
미디어 풀 (13개 도구)
도구 | 매개변수 | 설명 |
|
| 미디어 파일을 풀로 가져오기 |
| — | 루트 폴더의 모든 클립 나열 |
| — | 루트 폴더 정보 가져오기 |
|
| 하위 폴더 생성 |
|
| 현재 폴더 설정 |
|
| 풀에서 클립 삭제 |
|
| 클립을 폴더로 이동 |
|
| 클립 다시 연결 |
|
| 클립 연결 해제 |
|
| 메타데이터 CSV 내보내기 |
| — | 선택된 클립 나열 |
|
| 클립 선택 |
|
| 매트 파일 추가 |
타임라인 (21개 도구)
도구 | 매개변수 | 설명 |
|
| 새 빈 타임라인 생성 |
|
| 클립에서 타임라인 생성 |
| — | 모든 타임라인 나열 |
| — | 현재 타임라인 이름 가져오기 |
|
| 현재 타임라인 이름 변경 |
|
| 인덱스(1부터 시작)로 타임라인 전환 |
| — | 현재 타임라인 복제 |
|
| 타임라인 삭제 |
| — | 시작 프레임 가져오기 |
| — | 끝 프레임 가져오기 |
| — | 시작 타임코드 가져오기 |
|
| 시작 타임코드 설정 |
| — | 현재 타임코드 가져오기 |
|
| 현재 타임코드 설정 |
| — | 장면 전환 감지 |
|
| 자막 자동 생성 |
|
| 타임라인 내보내기 |
|
| 파일에서 타임라인 가져오기 |
|
| 타임라인에 클립 추가 |
|
| 타임라인 설정 가져오기 |
|
| 타임라인 설정 지정 |
타임라인 트랙 (도구 11개)
도구 | 매개변수 | 설명 |
|
| 트랙 수 세기(비디오/오디오/자막) |
|
| 트랙 추가 |
|
| 트랙 삭제 |
|
| 트랙 활성화/비활성화 |
|
| 트랙 활성화 여부 확인 |
|
| 트랙 잠금/잠금 해제 |
|
| 트랙 잠금 여부 확인 |
|
| 트랙 이름 가져오기 |
|
| 트랙 이름 설정 |
|
| 트랙의 클립 나열 |
| — | 선택된 타임라인 클립 나열 |
타임라인 항목 (도구 66개)
모든 항목 작업은 특정 클립을 대상으로 선택적 trackType, trackIndex, itemIndex를 허용하며, 생략하면 첫 번째 선택된 클립에 대해 작동합니다.
도구 | 매개변수 | 설명 |
|
| 클립 이름 가져오기 |
|
| 클립 이름 변경 |
|
| 클립 길이 가져오기 |
|
| 클립 시작 프레임 가져오기 |
|
| 클립 종료 프레임 가져오기 |
|
| 클립 속성 가져오기 |
|
| 클립 속성 설정 |
|
| 클립 활성화 여부 확인 |
|
| 클립 활성화/비활성화 |
|
| 클립 색상 설정 |
|
| 클립 색상 가져오기 |
|
| 클립 색상 지우기 |
|
| 플래그 추가 |
|
| 플래그 가져오기 |
|
| 플래그 지우기 |
|
| 마커 추가 |
|
| 마커 가져오기 |
|
| 제너레이터 삽입 |
|
| Fusion 제너레이터 삽입 |
| — | Fusion 컴포지션 삽입 |
|
| OFX 제너레이터 삽입 |
|
| 타이틀 삽입 |
|
| Fusion 타이틀 삽입 |
| — | 현재 프레임에서 스틸 캡처 |
| — | 모든 클립에서 스틸 캡처 |
|
| 컴파운드 클립 생성 |
| — | Fusion 클립 생성 |
|
| 타임라인으로 가져오기 |
|
| 클립 안정화 |
|
| 클립 스마트 리프레임 |
|
| 매직 마스크 생성 |
|
| 매직 마스크 재생성 |
|
| 클립의 트랙 정보 가져오기 |
|
| 연결된 항목 가져오기 |
|
| CDL 값 설정 |
|
| 테이크 추가 |
|
| 테이크 수 세기 |
|
| 테이크 선택 |
|
| 현재 테이크 확정 |
|
| 다른 클립에 그레이드 복사 |
|
| LUT 내보내기 |
|
| 컬러 출력 캐시 설정 |
|
| Fusion 출력 캐시 설정 |
|
| 클립 메타데이터 가져오기 |
|
| 클립 메타데이터 설정 |
|
| 클립 속성 가져오기 |
|
| 클립 속성 설정 |
|
| 프록시 미디어 연결 |
| — | 프록시 미디어 연결 해제 |
|
| 클립을 파일로 교체 |
|
| 클립 마커 추가 |
| — | 클립 마커 가져오기 |
|
| 클립 색상 설정 (미디어 풀) |
|
| 클립 플래그 추가 |
|
| 오디오 전사 |
|
| 마크 인/아웃 설정 |
|
| 마크 인/아웃 지우기 |
|
| 타임라인 마커 추가 |
| — | 타임라인 마커 가져오기 |
|
| 색상별 마커 삭제 |
|
| 프레임의 마커 삭제 |
|
| 현재 프레임을 스틸로 내보내기 |
|
| Fairlight 프리셋 적용 |
| — | 빠른 내보내기 프리셋 목록 |
Fusion 컴포지션 (도구 14개)
도구 | 매개변수 | 설명 |
|
| Fusion 컴포지션 생성 |
|
| 클립에 Fusion 컴포지션 추가 |
|
| .comp 파일 가져오기 |
|
| Fusion 컴포지션 내보내기 |
|
| 이름으로 컴포지션 로드 |
|
| 이름으로 컴포지션 삭제 |
|
| 컴포지션 이름 변경 |
|
| 클립의 Fusion 컴포지션 수 세기 |
|
| Fusion 컴포지션 이름 목록 |
| — | 현재 Fusion 컴포지션 가져오기 |
| — | 열린 모든 컴포지션 목록 |
| — | 새 Fusion 컴포지션 생성 |
|
| 현재 컴포지션 저장 |
|
| 컴포지션 파일 로드 |
| — | 현재 컴포지션 닫기 |
| — | 현재 컴포지션 렌더링 |
Fusion 도구 (도구 11개)
도구 | 매개변수 | 설명 |
| — | 현재 컴포지션의 모든 도구/노드 나열 |
|
| 이름으로 도구 찾기 |
|
| 도구 삭제 |
|
| 도구 속성 가져오기 |
|
| 도구 속성 설정 |
|
| 노드 추가 (Background, Paint, Merge 등) |
|
| 두 노드 연결 |
|
| 노드 입력 설정 (키프레임 가능) |
|
| 노드 입력 값 가져오기 |
|
| 현재 프레임 설정 |
| — | 현재 프레임 가져오기 |
갤러리 (도구 4개)
도구 | 매개변수 | 설명 |
| — | 갤러리 스틸 앨범 나열 |
| — | PowerGrade 앨범 나열 |
| — | 스틸 앨범 생성 |
| — | PowerGrade 앨범 생성 |
색상 / 노드 (도구 7개)
도구 | 매개변수 | 설명 |
| — | 현재 클립의 노드 수 가져오기 |
|
| 노드 레이블 가져오기 |
|
| 노드의 LUT 가져오기 |
|
| 노드에 LUT 설정 |
|
| 노드 활성화/비활성화 |
| — | 모든 그레이드 초기화 |
| — | LUT 목록 새로고침 |
렌더링 (도구 22개)
도구 | 매개변수 | 설명 |
| — | 렌더 포맷 나열 |
|
| 포맷에 대한 코덱 나열 |
| — | 현재 포맷/코덱 가져오기 |
|
| 렌더 포맷 및 코덱 설정 |
| — | 렌더 모드 가져오기 |
|
| 렌더 모드 설정 |
|
| 렌더 해상도 나열 |
| — | 렌더 프리셋 나열 |
|
| 렌더 프리셋 로드 |
|
| 새 렌더 프리셋 저장 |
|
| 렌더 프리셋 삭제 |
|
| 렌더 설정 지정 (TargetDir, CustomName 등) |
| — | 렌더 작업 추가 |
|
| 렌더 작업 삭제 |
| — | 모든 렌더 작업 삭제 |
| — | 렌더 작업 나열 |
|
| 렌더링 시작 |
| — | 렌더링 중지 |
| — | 렌더링 중인지 확인 |
|
| 렌더 작업 상태 가져오기 |
|
| 빠른 내보내기 |
|
| 작업 추가 및 렌더링 시작 |
음성 및 자막 (도구 1개)
도구 | 매개변수 | 설명 |
|
| AI 음성 오디오 생성 |
특수 (도구 1개)
도구 | 매개변수 | 설명 |
|
| 손그림 애니메이션 생성 (Daniel Batal 기법) |
문제 해결
브리지가 시작되지 않음
DaVinci Resolve가 실행 중이고 프로젝트가 열려 있는지 확인하세요
오류 메시지가 있는지 콘솔(Workspace → Console)을 확인하세요
DaVinci Resolve를 다시 시작하세요 — 시작 시에만 Scripts 폴더를 스캔합니다
"Resolve Bridge에 연결할 수 없음"
Resolve 내에서 Workspace → Scripts → Bridge-Connection-Script를 실행했는지 확인하세요
콘솔에
[Resolve Bridge] HTTP server running on http://127.0.0.1:8787이 표시되는지 확인하세요포트가 이미 사용 중이면 Resolve를 닫고 다시 여세요 (오래된
fuscript.exe프로세스가 포트를 점유할 수 있습니다)
도구가 오류를 반환함
연결을 확인하려면 먼저
resolve_status를 호출하세요일부 작업은 프로젝트가 열려 있고, 타임라인이 존재하며, 클립이 선택되어 있어야 합니다
브리지의 오류 메시지가 무엇이 누락되었는지 알려줍니다
기술 세부 사항
브리지 포트: 127.0.0.1:8787 (로컬호스트 전용, 외부 접근 불가)
전송: HTTP/1.0 with Connection: close
MCP 전송: stdio
의존성:
mcp,requests(MCP 서버 전용; 브리지는 순수 stdlib 사용)Resolve 버전: 18.5+ (21.0.4.5에서 테스트됨)
Python: 3.10+ (MCP 서버용); 브리지는 Resolve 내장 Python 사용
라이선스
MIT 라이선스 — LICENSE 파일 참조.
크레딧
The Geek Gods가 제작. DaVinci Resolve 스크립팅 커뮤니티에서 영감을 받았습니다.
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceExposes 20 tools for project, media, render, and timeline control in DaVinci Resolve 18+ via stdio MCP, enabling AI agents to operate the software through natural language.51MIT
- AlicenseNot gradedqualityFmaintenanceComprehensive MCP server for DaVinci Resolve with 295+ tools to control projects, timelines, editing, color grading, rendering, and more via natural language.3MIT
- AlicenseBqualityDmaintenanceEnables AI-driven DaVinci Resolve 21 automation with 88 tools for project management, timeline editing, color grading, AI analysis, rendering, and dailies creation.882MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that exposes the complete DaVinci Resolve scripting API, enabling AI assistants to control DaVinci Resolve programmatically with over 440 tools for project management, timeline editing, color grading, rendering, and more.5MIT
Related MCP Connectors
OCR, transcription, file extraction, and image generation for AI agents via MCP.
A real timeline video editor for AI agents: journaled edits, FFmpeg/MLT rendering, exports
MCP server for Clipkit — gives AI agents a video toolbox via the Clipkit schema.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Airta-Admin/Davinc-Resolve-Local-Bridge-MCP'
If you have feedback or need assistance with the MCP directory API, please join our Discord server