Claude Code 教學/第 19 篇・共 20 篇
Claude × DaVinci Resolve(二):安裝 MCP,讓 Claude 連上剪輯軟體
從我的 GitHub repo 一次取得剪輯教學與 Resolve MCP,分別設定 Studio 外部腳本與免費版橋接,再用唯讀指令驗證連線。
上一篇選好了 Resolve 版本,這篇開始把工具接起來。先準備好 Claude Code、已安裝的 Resolve,以及一個空的測試專案;免費版讀者請先確認使用前篇說明的 21.0.3.7。
這次的目標很小:讓 Claude 正確讀出 Resolve 的版本與目前專案名稱。 先不剪片,確定工具真的接通,再往下一步走。
本篇的社群 MCP 安裝流程依上游文件整理;免費版橋接並非我的個人實測。版本限制與官方下載連結請看第一篇。
一、準備工具,再安裝 MCP
如果還沒裝 Claude Code,先完成 新手安裝篇;Windows 讀者可看 Windows 安裝指南。Claude 的使用費用和 Resolve 是否免費,是分開的兩件事。
社群 MCP 需要 Python 3.10 以上;上游把 3.10~3.12 列為風險較低的選擇,這裡先用 3.12。準備好 Git 與 Python 3.12.10 官方安裝程式。Mac 的 Python 與 Resolve 請使用相容的處理器架構,Apple Silicon 不要混用 Intel Python。
打開終端機,切到你平常放專案的資料夾,第一次下載時執行:
git clone --recurse-submodules https://github.com/Imeipopo/claude-davinci-resolve-editing.git
cd claude-davinci-resolve-editing
這次從我的 repo 開始。--recurse-submodules 會一併下載 mcp/,裡面是原作者 samuelgursky 的 MCP server,保留其 MIT 授權;根目錄則是我的教學、Skill 與範例。
如果已經下載過我的 repo,請先更新到有 MCP 整合的版本,再於 repo 根目錄執行 git submodule update --init --recursive。若只有從 GitHub 按 Download ZIP,裡面不包含子模組,請改用上面的 Git 指令。
接著保持終端機在 claude-davinci-resolve-editing 根目錄,執行裡面的上游安裝器。Mac/Linux 使用:
python3 --version
python3 mcp/install.py --clients claude-code
請先看版本輸出,確認 python3 指向你要使用的 Python。Windows PowerShell 使用:
py -3.12 --version
py -3.12 mcp/install.py --clients claude-code
安裝器會在 mcp/ 內準備 Python 環境與 server,並把 Claude Code 設定寫入目前所在的根目錄的 .mcp.json。所以安裝與啟動 Claude Code 都要在 claude-davinci-resolve-editing 根目錄完成,不要先 cd mcp。這份本機設定已加入 Git 忽略清單,不會隨 repo 分享;也不要直接搬到別台電腦,裡面的路徑要依那台電腦重新設定。
mcp/ 使用我的 repo 記錄的上游版本。日後更新我的 repo 後,再執行 git submodule update --init --recursive,就能對齊教學指定的版本。詳細安裝選項以 上游安裝文件 為準。
二、打開 Resolve:Studio 和免費版走不同步驟
A. 你用 Studio 版
先儲存正在編輯的工作,開啟 Resolve 並進入測試專案。到:
Preferences → System → General → External scripting using → Local
儲存設定;如果程式提示需要重新啟動,先存檔再重開。Local 讓同一台電腦上的工具連入,不需要為了本文設定 Network。
B. 你用免費版 21.0.3.7
免費版要多裝一個在 Resolve 裡執行的小腳本。保持終端機位於剛剛的 claude-davinci-resolve-editing 根目錄。
Mac/Linux:
python3 mcp/scripts/install_resolve_bridge.py
Windows PowerShell:
py -3.12 mcp/scripts/install_resolve_bridge.py
安裝完成後,先儲存 Resolve 的工作再重新開啟程式,進入一個測試專案,選:
Workspace → Scripts → resolve_bridge
依安裝器提示,選單可能多一層 Utility。啟動後,這個橋接腳本會讓 MCP 從本機連上 Resolve;每次重新開啟 Resolve,也要確認橋接有啟動。
**Mac 如果找不到 Python 腳本:**先確認真的裝了免費版 21.0.3,而非 21.1。舊版 Resolve 尋找 Python 的方式和終端機不同,Homebrew、pyenv 等安裝方式可能需要額外設定。優先讀安裝器的檢查結果,再對照 上游的 Mac Python 說明;不要只因為終端機能執行 python3,就以為 Resolve 一定找得到。
橋接會在本機產生認證設定。不用把設定內容、金鑰或整個設定檔貼到聊天裡;排錯時貼遮掉私人資料後的錯誤訊息即可。腳本與路徑細節見 上游橋接安裝器。
Studio 21.1 也有官方串接入口
如果你使用 Studio 21.1,可以另外查看 File → Setup AI Assistants 的官方設定流程,選擇它偵測到的 Claude 客戶端。這是另一種連線選擇,和本文的社群 MCP 擇一開始,排錯會比較單純。
我的 repo 環境準備章 記錄了本機官方 MCP 工具清單,但沒有實測整套官方設定流程;不要把這個入口當成免費版也有的功能。
三、驗收連線:先讀取,再動手
讓 Resolve 保持開啟、已進入專案,沒有擋住操作的對話框。回到 claude-davinci-resolve-editing 根目錄的終端機,執行:
claude
首次開啟時檢查並信任你剛安裝的專案 MCP 設定,再輸入:
/mcp
找到安裝器新增的 Resolve server,確認狀態。接著把這段話貼給 Claude:
請透過 DaVinci Resolve 的 MCP 讀取:
1. Resolve 的完整版本,以及是不是 Studio。
2. 目前專案名稱。
3. 目前時間軸名稱與長度;沒有時間軸就明確告訴我。
這一步只讀取,不要建立、修改或刪除任何東西。
若連線失敗,請提供實際錯誤,不要猜測專案內容。
看到真實的版本與專案名稱,才算 Resolve 端也接通。 /mcp 顯示 server 已連線,只能證明 Claude 和 MCP server 接上,仍要確認 server 碰得到剪輯軟體。
如果卡住,先確認 Resolve 已完全載入、免費版橋接已啟動、Studio 的 Local 已打開,以及你有從帶著 .mcp.json 的資料夾啟動 Claude。需要進一步排錯時,可在另一個終端機切回同一資料夾,執行 python3 mcp/scripts/doctor.py;Windows 改用 py -3.12 mcp/scripts/doctor.py,再把檢查結果貼給 Claude。
讀到正確的版本與專案名稱,就完成這一篇了。保留目前設定,繼續讀第三篇:用我的開源教學,剪出第一支影片。
參考來源
- 社群 MCP 安裝文件:Python 條件、安裝器與客戶端設定。
- 免費版橋接說明、橋接安裝器:免費版操作與 Python 環境檢查。
- 我的環境準備章:Studio 設定與官方 MCP 工具清單的紀錄。
- Claude Code 官方 MCP 文件:專案設定、信任流程與
/mcp。