davinci-resolve-mcp MCP — 사용 사례, 설치 & 라이브 데모

왜 쓰나요

핵심 기능

27 tools covering 324 of 324 Resolve API methods (100%)
Universal installer auto-configures Claude Desktop/Code, Cursor, VS Code, Windsurf, Zed, JetBrains
Timeline manipulation: tracks, markers, clips, generators, titles
Per-clip transform, crop, composite, retime, keyframes
Fusion node-graph API for motion-graphics automation

라이브 데모

실제 사용 모습

davinci-resolve.replay ▶ 준비됨

0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "davinci-resolve": {
      "command": "uvx",
      "args": [
        "davinci-resolve-mcp"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "davinci-resolve": {
      "command": "uvx",
      "args": [
        "davinci-resolve-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "davinci-resolve": {
      "command": "uvx",
      "args": [
        "davinci-resolve-mcp"
      ],
      "_inferred": true
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "davinci-resolve": {
      "command": "uvx",
      "args": [
        "davinci-resolve-mcp"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "davinci-resolve",
      "command": "uvx",
      "args": [
        "davinci-resolve-mcp"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "davinci-resolve": {
      "command": {
        "path": "uvx",
        "args": [
          "davinci-resolve-mcp"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add davinci-resolve -- uvx davinci-resolve-mcp

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: davinci-resolve-mcp

Build a rough cut from a script + footage folder

👤 Video editors doing talking-head content ⏱ ~20 min intermediate

언제 쓸까: You have 2 hours of B-roll and a 3-page script and don't want to start in a black timeline.

사전 조건

DaVinci Resolve Studio 18.5+ open — Purchase once ($295) — free edition has no scripting API
Resolve preferences: System > General > External scripting using: Local — Restart Resolve after flipping it
MCP installed via the universal installer — git clone samuelgursky/davinci-resolve-mcp && python install.py

흐름

Create project and import media

Create a new project 'EP04_RoughCut', 1080p24, and import every .mov in ~/Footage/EP04 into a Media Pool folder called 'B-roll'.✓ 복사됨

→ Project open with folder populated
Build a timeline keyed to script beats

Create a new timeline. For each paragraph in ~/Footage/EP04/script.md, add a 6-second marker on track V2 labeled with the first 5 words.✓ 복사됨

→ Timeline with beat markers
Drop B-roll at each marker

At each marker, pick the closest-matching B-roll clip by filename keyword and place it on V1 at that marker.✓ 복사됨

→ Cut assembles visibly

결과: A rough cut you can refine manually, built in 5 minutes instead of an hour.

함정

Filename-based matching is noisy — Rename clips with descriptive prefixes, or use Resolve's built-in Voice Isolation / transcription for smarter matching
Resolve is sluggish while MCP tools run on huge projects — Work in a smaller 'assembly' project; conform to the big project later

함께 쓰기: filesystem

Batch-apply a color preset across an entire timeline

👤 Colorists doing assistant work ⏱ ~15 min intermediate

언제 쓸까: You want to stamp a base LUT + saturation bump across 60 clips before starting hand grading.

흐름

Inspect timeline structure

List every clip in the active timeline with in/out and source filename.✓ 복사됨

→ Clip inventory
Apply preset

For every clip, apply Power Grade 'EP04_Base' as the first node.✓ 복사됨

→ Thumbnails update
Flag clips that look wrong

Which clips look significantly outside the normal range after the preset? Suggest per-clip adjustments.✓ 복사됨

→ Short list of clips needing manual attention

결과: A consistent base grade applied in seconds, with manual-attention flags.

Export multiple deliverables from one timeline

👤 Editors delivering to YouTube + Instagram + broadcast ⏱ ~10 min beginner

언제 쓸까: Same cut, three export specs, don't want to click through the render page three times.

흐름

Queue all three renders

Queue renders for active timeline: YouTube 1080p H.264 to ~/Exports/yt.mp4, Instagram 1080x1350 to ig.mp4, ProRes 422 HQ to broadcast.mov.✓ 복사됨

→ 3 jobs in the render queue
Start and monitor

Start all queued jobs and report when done.✓ 복사됨

→ Completion status per job

결과: A multi-format delivery in one chat turn.

함께 쓰기: filesystem

조합

다른 MCP와 조합해 10배 효율

davinci-resolve + filesystem

Read a script/EDL from disk and cut against it

Read ~/Project/EP04/edl.txt and build a matching timeline in the current Resolve project.✓ 복사됨

davinci-resolve + after-effects

Finish VFX in AE then conform back into Resolve

After AE renders are done at ~/renders/vfx/, replace the corresponding placeholder clips in Resolve's timeline with the new files.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
resolve	action: str, params?: object	App-level: pages, layout, render presets	free (local)
project_manager	action, params	Create/open/delete projects, databases, cloud	free
project	action, params	Timelines, render pipeline, settings, LUTs	free
media_pool	action, params	Import, organize clips and timelines	free
timeline	action, params	Tracks, markers, items, generators	free
timeline_item	action, params	Per-clip properties, Fusion comps, versions, CDL	free
timeline_item_transform	item_id, pan?, tilt?, zoom?, rotation?	Reposition/resize a clip	free
timeline_item_keyframes	item_id, property, frame, value	Animate any keyframeable property	free
gallery	action, params	Stills and Power Grades	free
fusion_comp	action, params	Build/modify Fusion node graphs	free

비용 및 제한

운영 비용

API 쿼터: No network — everything is local scripting API
호출당 토큰: Most responses 200-800 tokens; timeline dumps can hit 5k on big edits
금액: DaVinci Resolve Studio one-time ~$295 (required). MCP itself is free/MIT.
팁: The cost is Resolve Studio and your render time; API calls are free. Ask for scoped lists (1 timeline, 1 track) not entire project dumps.

보안

권한, 시크릿, 파급범위

자격 증명 저장: No credentials — local scripting only

데이터 외부 송신: None. All API calls stay within Resolve.

절대 부여 금지: Remote network exposure of the MCP — keep it local

Enable 'External scripting using: Local' — never 'Network' unless you own the network end-to-end.
The MCP has full project control; don't run experiments on the project you're delivering today.

문제 해결

자주 발생하는 오류와 해결

No connection to DaVinci Resolve

Resolve must be running and 'External scripting using: Local' enabled; restart Resolve after flipping.

확인: Preferences > System > General shows Local

Free edition: scripting disabled

The free edition does not expose the scripting API. Upgrade to Studio.

Python version mismatch on macOS

Installer prefers Python 3.10-3.12. Use pyenv install 3.11.9 and re-run install.py.

확인: python3 --version

Operations time out on a 4K project

Resolve's scripting API is single-threaded and queues behind UI updates. Minimize Resolve's viewer panels during large batch ops.

대안

davinci-resolve-mcp 다른 것과 비교

대안	언제 쓰나	단점/장점
Adobe Premiere MCPs (community)	Your pipeline is Premiere, not Resolve	Less mature MCP ecosystem for Premiere
After Effects MCP	You're doing motion graphics, not edit/color	Different stage of the pipeline
Raw Python + Resolve API	You want total control and don't need AI	No MCP = no chat interface

davinci-resolve-mcp