DaVinci Resolve MCP 讓 AI 助理透過 Resolve Scripting API 操作專案、媒體池與時間軸，並提供輸出、調色及素材分析工具。另附離線進階伺服器，可處理專案與調色檔案；本手冊整理安裝方式、唯讀檢查流程及版本限制。
這是一個開源 MCP 伺服器。AI 用戶端將需求轉成工具呼叫，由伺服器連接正在執行的 Resolve，完成素材整理、時間軸檢查與後製操作。
即時伺服器使用 Python，預設採用 compound 模式。同一工具以 action 區分操作；需要逐一暴露 API 方法時，才切換 full 模式。另有 Node.js 進階伺服器，直接讀寫 .drp、.drt、.drx 等檔案。
適用於助理剪輯、後製流程自動化，以及需要讓 AI 讀取專案狀態的開發者。專案將產出定位為素材整理與初步組接；取捨鏡頭、節奏與完成剪輯仍需人工判斷。
本頁依 README 與同一版本的原始碼整理，來源快照為 16e4a3。上方工具數量是該 README 的公布值；本次未在 Resolve 中執行工具測試。
依安裝文件準備 Resolve 18.5 以上版本與 Python 3.10 以上版本。文件建議優先選擇 Python 3.10–3.12；較新的 Python 是否可用，仍需配合 Resolve 版本檢查。
使用 Studio 時，先開啟 Resolve，將 Preferences > General > External scripting using 設為 Local。以下先列 npm 安裝方式，再列原始碼安裝方式，選擇其中一種。
在可執行 npx 的環境輸入以下指令，依互動式安裝程式選擇 MCP 用戶端。安裝程式會建立 Python 虛擬環境並偵測 Resolve 路徑。
需要檢查或修改程式時，使用以下流程。python 必須指向符合需求的直譯器。
安裝程式支援 Claude Desktop、Claude Code、Cursor、Codex CLI 等用戶端。若要查看手動設定片段，在原始碼目錄執行 python instal；實際 Python 與伺服器路徑應採用安裝程式輸出的絕對路徑。
開啟一個測試專案，讓用戶端呼叫 resolv 與 projec。通過條件是回傳 Resolve 版本與目前專案名稱，且沒有連線錯誤。
npm 安裝後可執行 npx davinc 開啟本機面板。請使用啟動程式提供的完整網址，其中包含當次存取權杖。
以下依工作分類整理主要工具，並非完整清單。工具名稱與操作範圍來自 compound 伺服器及 README 能力表；實際可用功能仍受 Resolve 版本與環境影響。
| 模式 | 使用條件 |
|---|---|
| 複合 | 適合多數後製操作；需要連接執行中的 Resolve。 |
| 細分 | 需要逐方法呼叫 API 時使用；仍需連接 Resolve。 |
| 離線 | 處理專案與調色檔；不需開啟 Resolve。 |
即時模式的 Python 入口分別為 src/se 與 src/se。README 建議優先使用預設的 compound 模式。
離線進階伺服器使用 Node.js，入口為 bin/da。部分功能需要額外工具，先呼叫其 capabi 查詢當前狀態。
工具回傳成功與畫面變更一致，是兩項不同的檢查。以下原則來自專案的操作封裝、原始素材政策與已知 API 行為紀錄。
依專案設計，原始素材維持不變，分析報告寫入獨立目錄。但 analyz 預設可把摘要與標記寫回 Resolve 專案；若不需要，明確設定退出選項。
host_c 會提供畫面路徑與資料格式，由具視覺能力的 MCP 用戶端讀取影像。每個片段還需呼叫 commit；省略時會保留待處理狀態。
先查詢 render 的 probe_。格式與 codec 可用性受作業系統、授權和外掛影響，不應照抄另一台電腦的輸出參數。
透過 resolv 的 begin_ 與 end_ex 關聯多次呼叫，再以 export 匯出執行報告。報告未記錄驗證時，不能當成交付通過證明。
在 Resolve 開啟測試專案，並選擇要檢查的時間軸，再向已連線的 MCP 用戶端提出以下需求。這是依工具介面編寫的操作示例，不是實測對話；所有結果都應以讀者環境的實際回傳為準。
範例只查詢時間軸結構、間隙、重疊與可用輸出格式。下方採用「工具名稱＋參數」表示 MCP 呼叫，無須貼到終端機執行。
空白區間可能是預留段落；軌道重疊也可能是剪輯安排。這個流程提供位置與狀態，修正前仍須確認剪輯意圖。
若後續要建立輸出工作，先使用 valida 驗證設定，再於獲准後建立佇列。prepar 負責準備工作；開始算圖是另一個操作，詳見輸出工具文件。
python scripts/install_resolve_bridge.py ；重新開啟 Resolve、載入專案，再選 Workspace > Scripts > resolve_bridge 。PYTHON3HOME 或 /usr/local/bin/python3 。使用 launchctl setenv 的設定不會跨重新開機保存；依橋接文件檢查直譯器與函式庫路徑。TimelineItem.CopyGrades 會覆寫目標調色且不會自動建立可還原版本。對應操作要求 acknowledge_trap: true ；先備份與確認覆寫範圍，不要把此參數當成通用除錯開關。analyze_media 預設啟用視覺分析、轉錄及專案中繼資料發布。只需特定分析時，明確使用 include_visuals=false 、include_transcription=false 、publish_metadata=false 或 timed_markers=no 等文件列出的退出選項。doctor 或 capabilities 查詢；模型權重的授權與專案 MIT 授權分開。render(action="verify_output", params={"job_id":"實際工作 ID"}) ，並在刪除工作前完成驗證。本節依 README 的橋接、保護與限制說明、安全政策、素材分析指南及 render 工具原始碼整理。資料流向的提醒是根據 host-chat 視覺分析流程作出的操作建議。
1. 建立機器能力紀錄。先保存 Resolve 版本、連線方式與可用輸出格式。軟體更新後重新查詢，避免沿用失效的功能假設。
2. 在測試專案試跑素材分析。先指定報告目錄與所需分析項目，確認是否發布中繼資料。使用視覺分析時，檢查 commit 是否完成。
3. 加入可審閱的變更計畫。從支援 dry_ru 的操作開始，檢查目標片段、輸出位置與變更範圍，再執行寫入並回讀結果。
4. 依檔案作業需求加入離線伺服器。需要處理專案檔、調色檔或完成檔品質檢查時，參考 README 的進階伺服器設定。先呼叫其 capabi，確認所需相依套件。
① Installation and Configuration：環境條件、MCP 用戶端設定及診斷方式。
② Media Analysis Guide：原始素材保護、視覺分析及中繼資料發布。
③ Render / Deliver Kernel：輸出能力查詢、設定驗證及交付檢查。
專案程式碼採用 MIT 授權。Resolve 軟體、外部工具與模型權重的使用條件，請分別查閱各自的授權文件。