davinci-resolve-mcp MCP — 使用場景, 安裝 & 即時演示

為什麼要用

核心特性

27 個工具，涵蓋 324 個 Resolve API 方法中的 324 個（100%）
通用安裝程式可自動設定 Claude Desktop/Code、Cursor、VS Code、Windsurf、Zed、JetBrains
時間軸操作：軌道、標記、片段、產生器、字幕
每個片段的變換、裁切、合成、重新計時、關鍵影格
Fusion 節點圖 API，用於動態圖形自動化

即時演示

實際使用效果

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

根據腳本與素材資料夾建立粗剪版本

👤 從事談話類內容的影片剪輯師 ⏱ ~20 min intermediate

何時使用： 你有 2 小時的 B-roll 素材和 3 頁的腳本，不想從空白時間軸開始作業。

前置條件

DaVinci Resolve Studio 18.5+ 已開啟 — 一次性購買（$295）——免費版沒有腳本 API
Resolve 偏好設定：System > General > External scripting using: Local — 切換後重新啟動 Resolve
透過通用安裝程式安裝 MCP — git clone samuelgursky/davinci-resolve-mcp && python install.py

步驟

建立專案並匯入媒體

建立新專案 'EP04_RoughCut'，1080p24，並將 ~/Footage/EP04 中所有 .mov 檔案匯入名為 'B-roll' 的媒體池資料夾。✓ 已複製

→ 專案已開啟且資料夾已填入素材
依據腳本段落建立時間軸

建立新時間軸。針對 ~/Footage/EP04/script.md 中的每個段落，在 V2 軌道上新增一個 6 秒的標記，並以前 5 個字作為標籤。✓ 已複製

→ 時間軸已顯示段落標記
在每個標記處放置 B-roll 素材

在每個標記處，依檔名關鍵字選取最接近的 B-roll 片段，並放置在該標記的 V1 軌道上。✓ 已複製

→ 剪輯畫面已可見地拼接完成

結果： 在 5 分鐘內建立一個可手動精修的粗剪版本，而非花費一小時。

注意事項

以檔名為基礎的匹配結果不夠精確 — 為片段加上描述性前綴重新命名，或使用 Resolve 內建的 Voice Isolation／逐字稿功能進行更智慧的匹配
在大型專案中執行 MCP 工具時，Resolve 反應遲緩 — 在較小的「組合剪輯」專案中作業，之後再套用到大型專案

搭配使用： filesystem

對整個時間軸批次套用調色預設

👤 從事助理工作的調色師 ⏱ ~15 min intermediate

何時使用： 你想在開始手動調色前，先對 60 個片段統一套用基礎 LUT 與飽和度提升。

步驟

檢視時間軸結構

列出目前時間軸中的所有片段，包含入出點與來源檔名。✓ 已複製

→ 片段清單已列出
套用預設

對每個片段，將 Power Grade 'EP04_Base' 套用為第一個節點。✓ 已複製

→ 縮圖已更新
標記看起來有問題的片段

套用預設後，哪些片段看起來明顯超出正常範圍？請建議每個片段需要調整的地方。✓ 已複製

→ 需要手動處理的片段短清單

結果： 在幾秒內套用一致的基礎調色，並標記需要手動處理的片段。

從單一時間軸匯出多種交付格式

👤 需要同時交付 YouTube、Instagram 與廣播格式的剪輯師 ⏱ ~10 min beginner

何時使用： 同一個剪輯版本需要三種匯出規格，不想在算圖頁面重複點選三次。

步驟

將三種算圖加入佇列

為目前時間軸排入算圖佇列：YouTube 1080p H.264 輸出至 ~/Exports/yt.mp4、Instagram 1080x1350 輸出至 ig.mp4、ProRes 422 HQ 輸出至 broadcast.mov。✓ 已複製

→ 算圖佇列中出現 3 個工作
開始算圖並監控進度

開始所有佇列中的工作，並在完成後回報狀態。✓ 已複製

→ 每個工作的完成狀態

結果： 在一次對話中完成多格式交付。

搭配使用： filesystem

組合

與其他 MCP 搭配，撬動十倍槓桿

davinci-resolve + filesystem

從磁碟讀取腳本或 EDL 並依此剪輯

讀取 ~/Project/EP04/edl.txt 並在目前的 Resolve 專案中建立對應的時間軸。✓ 已複製

davinci-resolve + after-effects

在 AE 中完成視覺特效後套回 Resolve

AE 算圖完成後，將 ~/renders/vfx/ 中的檔案替換掉 Resolve 時間軸中對應的佔位片段。✓ 已複製

工具

此 MCP 暴露的能力

工具	輸入參數	何時呼叫	成本
resolve	action: str, params?: object	應用程式層級：頁面、版面配置、算圖預設	free (local)
project_manager	action, params	建立、開啟、刪除專案、資料庫、雲端	free
project	action, params	時間軸、算圖流程、設定、LUT	free
media_pool	action, params	匯入、整理片段與時間軸	free
timeline	action, params	軌道、標記、項目、產生器	free
timeline_item	action, params	每個片段的屬性、Fusion 合成、版本、CDL	free
timeline_item_transform	item_id, pan?, tilt?, zoom?, rotation?	重新定位或縮放片段	free
timeline_item_keyframes	item_id, property, frame, value	為任何可設定關鍵影格的屬性製作動畫	free
gallery	action, params	靜幀與 Power Grade	free
fusion_comp	action, params	建立或修改 Fusion 節點圖	free

成本與限制

運行它的成本

API 配額: 無需網路——所有操作皆為本機腳本 API
每次呼叫 Token 數: 多數回應為 200-800 個 token；大型剪輯的時間軸輸出可能達到 5k
費用: DaVinci Resolve Studio 一次性費用約 $295（必要）。MCP 本身為免費／MIT 授權。
提示: 費用在於 Resolve Studio 授權與算圖時間；API 呼叫本身免費。請指定範圍進行查詢（1 個時間軸、1 條軌道），而非傾印整個專案的資料。

安全

權限、密鑰、影響範圍

憑證儲存： 無需憑證——僅限本機腳本

資料出站： 無。所有 API 呼叫均在 Resolve 內部進行。

切勿授予： Remote network exposure of the MCP — keep it local

啟用「External scripting using: Local」——除非你完全掌控整個網路，否則絕對不要選「Network」。
MCP 擁有完整的專案控制權；請勿在今天要交付的專案上執行實驗性操作。

故障排查

常見錯誤與修復

No connection to DaVinci Resolve

Resolve 必須正在執行，且已啟用「External scripting using: Local」；切換後請重新啟動 Resolve。

驗證： Preferences > System > General shows Local

Free edition: scripting disabled

免費版不提供腳本 API。請升級至 Studio 版本。

Python version mismatch on macOS

安裝程式偏好使用 Python 3.10-3.12。請使用 pyenv install 3.11.9 後重新執行 install.py。

驗證： python3 --version

Operations time out on a 4K project

Resolve 的腳本 API 為單執行緒，會在 UI 更新後排隊執行。執行大量批次操作時，請縮小 Resolve 的預覽面板。

替代方案

davinci-resolve-mcp 對比其他方案

替代方案	何時用它替代	權衡
Adobe Premiere MCPs (community)	你的工作流程是 Premiere 而非 Resolve	Premiere 的 MCP 生態系尚不成熟
After Effects MCP	你從事的是動態圖形而非剪輯／調色	屬於流程的不同階段
Raw Python + Resolve API	你想要完全的控制權且不需要 AI	沒有 MCP 就沒有對話介面

davinci-resolve-mcp