Resolve 的 AI 操作介面
這是一個開源 MCP 伺服器。AI 用戶端將需求轉成工具呼叫，由伺服器連接正在執行的 Resolve，完成素材整理、時間軸檢查與後製操作。
**即時伺服器使用 Python，預設採用 compound 模式。**同一工具以 action 區分操作；需要逐一暴露 API 方法時，才切換 full 模式。另有 Node.js 進階伺服器，直接讀寫 .drp、.drt、.drx 等檔案。
適用於助理剪輯、後製流程自動化，以及需要讓 AI 讀取專案狀態的開發者。專案將產出定位為素材整理與初步組接；取捨鏡頭、節奏與完成剪輯仍需人工判斷。
本頁依 README 與同一版本的原始碼整理，來源快照為 16e4a39。上方工具數量是該 README 的公布值；本次未在 Resolve 中執行工具測試。
連線
讀取狀態
規劃
確認變更
執行
回讀驗證
“This project treats camera originals and source media as immutable.”
安裝與 Studio 設定
依安裝文件準備 Resolve 18.5 以上版本與 Python 3.10 以上版本。文件建議優先選擇 Python 3.10–3.12；較新的 Python 是否可用，仍需配合 Resolve 版本檢查。
使用 Studio 時，先開啟 Resolve，將 Preferences > General > External scripting using 設為 Local。以下先列 npm 安裝方式，再列原始碼安裝方式，選擇其中一種。
npm 管理安裝
在可執行 npx 的環境輸入以下指令，依互動式安裝程式選擇 MCP 用戶端。安裝程式會建立 Python 虛擬環境並偵測 Resolve 路徑。
npx davinci-resolve-mcp setup
npx davinci-resolve-mcp doctor原始碼安裝
需要檢查或修改程式時，使用以下流程。python 必須指向符合需求的直譯器。
git clone https://github.com/samuelgursky/davinci-resolve-mcp.git
cd davinci-resolve-mcp
python install.py安裝程式支援 Claude Desktop、Claude Code、Cursor、Codex CLI 等用戶端。若要查看手動設定片段，在原始碼目錄執行 python install.py --clients manual；實際 Python 與伺服器路徑應採用安裝程式輸出的絕對路徑。
連線檢查與控制面板
開啟一個測試專案，讓用戶端呼叫 resolve_control(action="get_version") 與 project_manager(action="get_current")。通過條件是回傳 Resolve 版本與目前專案名稱，且沒有連線錯誤。
npm 安裝後可執行 npx davinci-resolve-mcp control-panel 開啟本機面板。請使用啟動程式提供的完整網址，其中包含當次存取權杖。
後製 能力總覽
以下依工作分類整理主要工具，並非完整清單。工具名稱與操作範圍來自 compound 伺服器及 README 能力表；實際可用功能仍受 Resolve 版本與環境影響。
01 · 狀態
resolve_control
應用程式狀態
讀取版本與頁面、檢索已知 API 行為，以及查看跨工具執行紀錄。
02 · 專案
project_manager
專案生命週期
列出與載入專案，提供設定快照、匯入、匯出及封存操作。
03 · 素材
media_pool
媒體池整理
匯入素材、整理 bin、檢查中繼資料，以及處理代理檔與重新連結的限制。
04 · 剪輯
timeline
時間軸操作
讀取軌道與片段、檢查間隙和重疊，並提供範圍操作及片段複製。
05 · 分析
media_analysis
素材分析
依已安裝的分析工具進行轉錄、同步事件偵測與畫面分析，保存報告及中繼資料。
06 · 調色
timeline_item_color
調色檢查
探查節點圖、驗證 CDL、處理 DRX，以及建立和還原調色版本快照。
07 · 合成
fusion_comp
Fusion 節點
讀取合成與連接埠，建立工具、設定輸入並驗證節點連線。
08 · 輸出
render
輸出規劃
查詢格式與編碼器、驗證設定、建立佇列工作，以及檢查輸出檔案。
09 · 離線
davinci-resolve-advanced
專案檔處理
透過另一個 MCP 伺服器處理專案、時間軸及調色檔案，另提供媒體與交付品質檢查。
伺服器模式選擇
| 模式 | 使用條件 |
|---|---|
| 複合 | 適合多數後製操作；需要連接執行中的 Resolve。 |
| 細分 | 需要逐方法呼叫 API 時使用；仍需連接 Resolve。 |
| 離線 | 處理專案與調色檔；不需開啟 Resolve。 |
即時模式的 Python 入口分別為 src/server.py 與 src/server.py --full。README 建議優先使用預設的 compound 模式。
離線進階伺服器使用 Node.js，入口為 bin/davinci-resolve-advanced-mcp.mjs。部分功能需要額外工具，先呼叫其 capabilities 查詢當前狀態。
探查、確認與 回讀
工具回傳成功與畫面變更一致，是兩項不同的檢查。以下原則來自專案的操作封裝、原始素材政策與已知 API 行為紀錄。
變更前的狀態探查
先讀取目前專案、時間軸與素材池。變更前若有對應的 probe_*、*_capabilities 或 dry_run 操作，先使用該入口檢查條件。
來源 · 伺服器操作指引
操作結果的證據欄位
閱讀回傳的 _operation，分別檢查狀態、驗證與警告。unverified 表示缺少驗證；未提供 changes 不能解讀為沒有變更。
來源 · 操作結果封裝
原始素材與分析輸出的分離
依專案設計，原始素材維持不變，分析報告寫入獨立目錄。但 analyze_media 預設可把摘要與標記寫回 Resolve 專案；若不需要，明確設定退出選項。
來源 · 素材分析指南
畫面分析的完成條件
host_chat_paths 會提供畫面路徑與資料格式，由具視覺能力的 MCP 用戶端讀取影像。每個片段還需呼叫 commit_vision；省略時會保留待處理狀態。
來源 · 用戶端視覺分析
本機輸出能力的查詢
先查詢 render 的 probe_render_matrix。格式與 codec 可用性受作業系統、授權和外掛影響，不應照抄另一台電腦的輸出參數。
來源 · 輸出工具文件
可追溯的多步操作
透過 resolve_control 的 begin_execution 與 end_execution 關聯多次呼叫，再以 export_execution_report 匯出執行報告。報告未記錄驗證時，不能當成交付通過證明。
來源 · 執行追蹤說明
交付前的 時間軸檢查
在 Resolve 開啟測試專案，並選擇要檢查的時間軸，再向已連線的 MCP 用戶端提出以下需求。這是依工具介面編寫的操作示例，不是實測對話；所有結果都應以讀者環境的實際回傳為準。
範例只查詢時間軸結構、間隙、重疊與可用輸出格式。下方採用「工具名稱＋參數」表示 MCP 呼叫，無須貼到終端機執行。
$ 使用者 › 檢查目前時間軸的間隙、重疊與可用輸出格式。只提供報告，保留現有專案狀態。
> resolve_control(action="get_version")
> project_manager(action="get_current")
> timeline(action="get_current")
> timeline(action="probe_timeline_structure")
> timeline(action="detect_gaps_overlaps")
> render(action="probe_render_matrix")
$ 使用者 ›
將結果整理成「專案／時間軸」、「需人工確認的範圍」、「可用格式」、「未驗證項目」四欄。
檢查結果的判讀
空白區間可能是預留段落；軌道重疊也可能是剪輯安排。這個流程提供位置與狀態，修正前仍須確認剪輯意圖。
若後續要建立輸出工作，先使用 validate_render_settings 驗證設定，再於獲准後建立佇列。prepare_render_job 負責準備工作；開始算圖是另一個操作，詳見輸出工具文件。
操作限制與 注意事項
本節依 README 的橋接、保護與限制說明、安全政策、素材分析指南及 render 工具原始碼整理。資料流向的提醒是根據 host-chat 視覺分析流程作出的操作建議。
工作流程的 擴充路徑
由唯讀檢查到後製自動化
**1. 建立機器能力紀錄。**先保存 Resolve 版本、連線方式與可用輸出格式。軟體更新後重新查詢，避免沿用失效的功能假設。
**2. 在測試專案試跑素材分析。**先指定報告目錄與所需分析項目，確認是否發布中繼資料。使用視覺分析時，檢查 commit_vision 是否完成。
**3. 加入可審閱的變更計畫。**從支援 dry_run 的操作開始，檢查目標片段、輸出位置與變更範圍，再執行寫入並回讀結果。
**4. 依檔案作業需求加入離線伺服器。**需要處理專案檔、調色檔或完成檔品質檢查時，參考 README 的進階伺服器設定。先呼叫其 capabilities，確認所需相依套件。
官方專案文件
① Installation and Configuration：環境條件、MCP 用戶端設定及診斷方式。 ② Media Analysis Guide：原始素材保護、視覺分析及中繼資料發布。 ③ Render / Deliver Kernel：輸出能力查詢、設定驗證及交付檢查。
專案程式碼採用 MIT 授權。Resolve 軟體、外部工具與模型權重的使用條件，請分別查閱各自的授權文件。