DaVinci Resolve MCP：389 个工具让 Agent 接管达芬奇，21.1 把免费版挡在门外
今天拆的是 DaVinci Resolve MCP：一个把达芬奇的 361 个脚本接口包成 MCP 工具的本地服务端，让编码 Agent 直接动你的时间线、调色和渲染队列；文章给全它在链条上的位置、两条安装入口、六处已知阻塞，以及 295 美元那道门槛值不值得迈。
samuelgursky/davinci-resolve-mcp 是一个跑在本机的 MCP 服务端，把 DaVinci Resolve 的官方脚本 API 包成 Agent 能直接调的工具：读工程、理媒体池、动时间线、改调色、排队渲染。仓库用 MIT 许可，2025 年 3 月建仓，到今天有 3,016 star、347 fork、992 次提交、437 个 tag，最近一次提交在北京时间 9 月 20 日凌晨 0:54；同名 npm 包上周被下载 18,570 次。12它自己不出画面，也不生成素材。渲染由 Resolve 完成，转写、静音检测、画面相似度这些能力挂在可选依赖上，缺哪个就报哪个的安装命令。3它负责的是把 Resolve 那套脚本接口翻成工具，再把每次调用的结果核对一遍。
它在链条上站在哪一层
前面几期拆的方案各自换掉链条上的一环：kinocut 把 FFmpeg 包成有类型的工具，FableCut 在浏览器里自带一条时间线。这一期换的是另一件事——你已经有 DaVinci Resolve，有正在剪的工程，缺的是一个让 Agent 伸得进去的接口。
这件事的分量来自 Resolve 自己的位置。Blackmagic 把 Resolve 描述成把剪辑、调色、视觉特效、动态图形、音频后期和照片编辑合在一处的软件，付费的 Studio 版是一次性 295 美元。4在这台软件上开一个脚本口，等于把一批专业工具的能力短接到 Agent 上，而不用另起一条自己实现剪辑逻辑的路。它站在接入层：上面是你的编码 Agent，下面是那台已经装好的剪辑台。
它在这一层怎么做事
服务端有两种形态。默认的 compound 模式把相关操作收进 action 参数，一共 37 个工具，为的是少占模型上下文；granular 模式把每个 API 方法单独摊开，是 389 个工具。3再往下一层还有 18 个离线工具，不启动 Resolve，直接读写
.drp / .drt / .drx 和项目数据库。覆盖面按项目自己的统计：脚本 API 方法 361 个，占旧版基线文档的 100%，其中 338 个有实测记录（93.6%），实测通过率 338/338；测试环境是 Resolve 19.1.3 Studio、20.3.2 Studio、21.0.2 Studio 和 21.0.3 免费版（免费版走内嵌桥）。5同一份文档里另有一处写的是 36 个 compound 工具、365 个 granular 工具，与徽章和正文的 37 / 389 对不上，这里两处并列，不替读者取舍。
每次调用返回的东西，除了结果本身还有一个
_operation 块：状态分成成功、部分成功、被拦下和失败，验证结果里把「Resolve 说成功、读回来却不一致」单独列成一类，另外附上这次改动了什么、有哪些警告和本次执行的编号。3连着几步的操作会被串成一条执行轨迹，可以导出成 Markdown 或 JSON 的审计文件；动手前的预检会按工具、动作和参数给出四档风险，以及影响范围是单个素材、整条轨道、整条时间线还是整个工程。仓库里还留了一份
src/utils/api_truth.py，记的是对着真实 Resolve 版本量出来的行为：那些返回 True 却什么也没做的调用、被静默丢掉的设置项、签名里有而运行时根本没有的方法。其中一条会被直接拒绝——TimelineItem.CopyGrades 会把目标片段的调色整体覆盖，覆盖时照样返回 True，并且不留可回退的版本；调用方必须写 acknowledge_trap: true 才放行。3另外附了一个本机的控制面板：默认只绑回环地址，用一次性 token 打开浏览器页面，可以看工程状态、分析进度和索引，也能就地发起一次素材分析。3
docs/images/control-panel/01-overview.png）：面板底部写明源素材只读、输出留在当前工程的分析目录；界面里的版本号是项目自己上传这张图时的版本，不是当前版本。3你要给什么，它交回什么
你要给的东西不多，但一条都不能少：
- 一台装着 DaVinci Resolve 18.5 以上的机器，Studio 版或免费版（免费版有前提，见第一条阻塞）
- Python 3.10 以上，项目建议 3.10–3.12 这一段最稳
- Resolve 正在运行，并且把 Preferences ▸ General ▸ External scripting using 设为 Local（选 Network 时要把
RESOLVE_SCRIPT_HOST指向 Resolve 那台机器） - 可选依赖按需装：ffmpeg、numpy、librosa、openai-whisper、open_clip_torch、transformers、opencv-python，少哪个，对应能力就报自己的安装命令6
它交回的是这些：
- 一个本地 stdio 的 MCP 服务端，默认不开网络监听；两个可选的本机 HTTP 面（控制面板、网络传输）只绑回环地址，每次启动换一个 token，并对 Host 和 Origin 做检查，防的是 DNS 重绑定和 CSRF3
- 一张铺得很宽的工具清单：应用与工程控制、媒体池与导素材、源安全的素材分析、时间线剪辑与套底、审阅标记、调色与 Fusion、Fairlight 音频、渲染与交付、扩展作者（Fuse、DCTL、Lua/Python 脚本的安装与卸载）3
- 一份写给 Agent 看的操作手册
docs/SKILL.md，以及可以直接通过 MCP 读的剪辑、调色、音频和流程文本文档
有几件事它明确不做，理由也写在仓库里：不替你挑哪一条 take 最好用，因为一条表演好不好，波形和转写稿都测不出来，它只给流畅度排序，让你先找到干净的备选；不把音乐剪辑自动化，可选依赖给节拍和切点方案，装配仍由人定；不评价一个剪辑好不好，所以破坏性动作一律走先计划、再复核、最后确认；不改你的源素材。它产出的是一稿粗装，等着你剪成片。3
最短的上手路径与花费
一条命令：
npx davinci-resolve-mcp setup装完它会顺手配置 Claude Desktop、Claude Code、Codex CLI、Cursor、VS Code、Windsurf、Zed、Continue、Cline、Roo Code、OpenCode 和 JetBrains 系 IDE。3想从源码走，就 clone 下来跑
python install.py。验收方式也不绕：开着 Resolve，对 Agent 说一句「列出所有工程，打开名叫 My Film 的那个」。花费的结论先说：服务端本身不花钱，钱花在它驱动的那台软件上。DaVinci Resolve Studio 是 295 美元的一次性授权；免费版从 21.1 起不再提供 Python 脚本能力，下面第一条阻塞讲的就是这件事。47
会卡住的地方
免费版在 21.1 上已经没有 Python 脚本这一面
症状：按文档装好内嵌桥、重启 Resolve，
Workspace ▸ Scripts 里始终不出现那几个 .py，而同一目录下的 Lua 探针正常列出。
触发条件：用免费版 DaVinci Resolve 21.1 跑内嵌桥。
现状：Resolve 21.1 于 2026-09-08 发布。8Blackmagic 在 21.1 的更新说明里写的是，把用 Python 写脚本的能力移到了 Studio 版，理由是免费版有人拿 Python API 去解锁 Studio 功能。79项目方的处理是把桥的适用范围改成只覆盖免费 21.0.x，并在文档里写明免费 21.1 不再在 Scripts 菜单列出 .py。3报告这件事的用户在免费 21.1 的 Console 里也没找到任何 Python 面板，只剩一个统一控制台；109 月 16 日又有人在 Windows 上确认，Console 里能拿到的是一个 Lua 5.1 环境和一个注入好的 resolve 对象。10
你能怎么办：买 Studio；或者把免费版留在 21.0.x 走内嵌桥；或者等一条基于 Lua 的桥——第三条目前只是报告者在 Console 里验证到的可能性，还没有实现。它必须和 Resolve 同时开在一台机器上
症状：工具连不上，或者脚本调用没有响应。
触发条件：把服务端装在另一台机器上；或者想在没有界面的情况下跑。
现状：安装文档要求 Resolve 正在运行并打开脚本偏好。6仓库里有一份专门的实测文档：在 GUI 和
-nogui 两种会话下，导入、拼剪和往返的结果逐字节一致，但前提是无头实例先能连上外部脚本。文档还记录了一种现场配置，-nogui 启动出来的实例永远不回应 scriptapp('Resolve')，而它占着每台机器一个的单例，界面版也跟着起不来。这份测量是在 Resolve Studio 19.1.3 上做的。11网络传输此前在非回环地址上会被一律拒绝（HTTP 421），这条已于 2026-09-16 关闭。12
你能怎么办：动手之前先花 30 秒跑一遍仓库里的预检（python scripts/resolve_headless.py run -- python -c "print('ok')"），拿到 ok 再排无头流程。11版本号刷得比你的升级节奏快
症状：升级之后某个动作的行为变了，或者某个参数的处理方式变了。
触发条件：让 Agent 直接跟着 npm 上的 latest 走。
现状：从北京时间 9 月 19 日 18:00 到 9 月 20 日 0:54，不到 7 个小时里这个仓库发了 14 个 release（v4.7.11 到 v4.8.13），其中五条的说明只有一句「仅测试工具链变更，工具、动作和 Resolve 行为不变」。13npm 上累计有 396 个版本。2
你能怎么办：把版本锁住，升级前读那一条 release note。最新的 v4.8.13 修的是
include_linked="false" 被当成字符串集合的问题：调用方传字符串 "false" 时，重链标志落到了默认打开的那一侧，正好是它想要的反面。13
官方自己也带了一套 MCP，两边的能力面对不上
症状：以为装了社区版就等于用上官方那套，或者反过来以为官方那套已经覆盖。
触发条件：在 Resolve 21.1 上同时看到官方的 AI 助手接入和这个社区服务端。
现状：Blackmagic 在 21.1 的新闻稿里写明，这一版支持接入 Claude、Claude Code 和 ChatGPT Codex 这类 AI 助手，用日常对话就能分析工程、整理媒体、改设置和批量渲染。8社区这边开了一条跟踪单逐条对齐两边的差集（#207，2026-09-09 开，到今天 28 条评论），里面记的是实测行为而不是方法名比对：
Project.SetSettings 和 Timeline.SetSettings 在批量参数里遇到一个非法键时会部分生效并返回 false；UpdateRenderPreset 返回 True，但要退出重开 Resolve 才生效；GetProjectLastModifiedTime 在已保存的工程上返回 None；SetHighPriority 的无参调用在 21.1 上什么也不做；ImportOptions.sourceClipsFolders 在官方和社区两个界面上都到不了。14
你能怎么办：先决定你要的是官方那条还是社区这条，再把 21.1 的新能力按 release note 的类别逐条验证，别按方法名判断有没有被覆盖。14
有一个操作会「成功地」毁掉调色
症状：目标片段的调色被整体替换，没有可回退的版本，而调用返回的是成功。
触发条件：对一个带手工调色的片段执行复制调色（
TimelineItem.CopyGrades）。
现状：项目把这条行为记进了 src/utils/api_truth.py，做法是把每种状态烘焙成 33 点 LUT 再逐字节比对，结论是它覆盖目标、返回 True、且不生成任何版本。现在这条动作会被服务端拒绝，除非调用方显式传 acknowledge_trap: true，或者用环境变量关掉整道护栏。3
你能怎么办：把这道护栏留着。真要执行这条操作，先给目标片段存一个版本或静帧，再显式确认。macOS 上 Resolve 只从两个地方找 Python
症状：安装器的预检说配置正确，
Workspace ▸ Scripts 里却一个脚本都不出现。
触发条件：Mac 上只有 Homebrew、pyenv、uv 或 conda 装的 Python。
现状：Resolve 找 Python 3 只认两处——先看 PYTHON3HOME 环境变量，再看 /usr/local/bin/python3，两处都没有，脚本就静默不列出。3更细的一条是：前缀里必须同时有 lib/libpython3.X.dylib 和名字不带版本号的 bin/python3，Homebrew 的 framework 构建常常只有 bin/python3.13，而安装器的预检当时只看 dylib，于是给出「可用」的结论。15launchctl setenv 设的环境变量重启之后就不在了，几周后脚本突然不再列出，原因往往在这里。3
你能怎么办：用 launchctl setenv 指好解释器并在重启后重设，或者把解释器软链到 /usr/local/bin/python3——这一步要 sudo，链之前先确认它没排在你平时用的 Python 前面。3许可与真实成本
服务端本身是 MIT 许可，商用和再分发都行，保留版权声明即可。1它调用的可选依赖各自带自己的许可：ffmpeg 是 LGPL/GPL，以子进程方式调用、不打包进发行物；numpy 是 BSD；librosa 是 ISC；openai-whisper 和 open_clip_torch 是 MIT；transformers 和 opencv-python 是 Apache-2.0；模型权重另有独立许可，商用前要单独看。6
真正的门槛在它驱动的那台软件上：DaVinci Resolve Studio 295 美元一次性授权；免费版从 21.1 起不再提供 Python 脚本能力，所以「免费版也跑得起来」这个前提只对 21.0.x 成立。47
这里没有按次计费。整套东西跑在你自己的机器上，成本是你的算力和 Agent 的 token。仓库背后是一家叫 Bradford Operations 的公司，把同一个 MCP 打包进了还在闭测的商业产品 Post Assistant，名额要去官网申请；开源的两个服务端本身是完整的，不依赖那个产品。316
和之前几期放在一起看
| 方案 | 你给它什么 | 它给你什么 | 它在这一层 | 许可与公开体量 |
|---|---|---|---|---|
| 本期：DaVinci Resolve MCP | 一台装着 Resolve 的机器、Python 3.10+、开着的 Resolve 界面 | 37 个（默认）或 389 个 MCP 工具，覆盖 361 个脚本 API 方法 | 给已装好的专业 NLE 装 Agent 接口 | MIT，3,016 star，992 次提交1 |
| kinocut | FFmpeg 和 Python 环境 | 196 个 MCP 工具与一张渲染回执 | FFmpeg 的执行与验证层 | Apache-2.0，160 star17 |
| FableCut | 一个浏览器 | 一条 JSON 时间线和 MCP / REST 入口 | 自带编辑器的浏览器端 | MIT，675 star18 |
| FireRed-OpenStoryline | 一份 config.toml 和几个模型 key | 18 个工具节点串起的成片产线 | 自带 Agent 的成片流水线 | Apache-2.0，3,427 star19 |
| video-use | 一堆原始素材和转写额度 | 读着词级转写稿剪出的 final.mp4 | 装进编码 Agent 的剪辑技能包 | MIT，25,224 star20 |
| video-shotcraft | 一条模板指令 | 157 张镜头配方卡排出的宣传片 | 镜头与素材资产库 | Apache-2.0，9,103 star21 |
| OpenMontage | 一个编码 Agent | 12 条视频管线跑到 final.mp4 | 编排层 | AGPL-3.0，60,430 star22 |
| HyperFrames | HTML 和组件代码 | 浏览器里的渲染底座 | 渲染底座 | Apache-2.0，51,947 star23 |
| hypit | 一份需求描述 | 一条从脚本到成片的流程 | 编排层 | 自订许可，11,859 star24 |
今天该不该动手
今天就动手：你已经在用 Resolve 剪片子，手里有一批重复到烦的活——批量整理媒体、给同一批素材打标记、按固定规格排队渲染、把审阅标记汇总成报告——而且你愿意为 Studio 付那 295 美元。这个方案解决的是「让 Agent 伸进已有工程」这一件事，它在这一点上比前几期的方案都直接：编辑器不用换，工程格式也不用动。
先收藏：你在用免费版，而且已经升到 21.1。这时候装它只会撞上第一节那条阻塞——脚本面已经被官方移走，社区桥停在 21.0.x。等两种情况之一再回来：你买了 Studio，或者有人把 Lua 那条路做出来并在 issue 里给出实测。
跳过：你要的是无头批处理、或者一台服务器上跑几十条片子的产线。这个方案的每一步都要求一台开着的 Resolve 和它的图形界面，付费软件也绑在那一台机器上；这类活交给 FFmpeg 那一层的方案更合适。
不管走哪条，先做一件事：把它锁在一个版本上，别让升级替你决定行为。
References
- 1samuelgursky/davinci-resolve-mcp
github.com
- 2davinci-resolve-mcp - npm
npmjs.com
- 3README
raw.githubusercontent.com
- 4DaVinci Resolve | Blackmagic Design
blackmagicdesign.com
- 5API Coverage and Test Results
raw.githubusercontent.com
- 6Installation and Configuration
raw.githubusercontent.com
- 7
- 8Blackmagic Design Announces DaVinci Resolve 21.1
blackmagicdesign.com
- 9DaVinci Resolve 21.1 update notes
blackmagicdesign.com
- 10
- 11Building edits headless: the iterative loop
raw.githubusercontent.com
- 12
- 13
- 14
- 15
- 16Bradford Post Assistant
bradfordoperations.com
- 17KyaniteLabs/kinocut
github.com
- 18ronak-create/FableCut
github.com
- 19FireRedTeam/FireRed-OpenStoryline
github.com
- 20browser-use/video-use
github.com
- 21Vincentwei1021/video-shotcraft
github.com
- 22calesthio/OpenMontage
github.com
- 23heygen-com/hyperframes
github.com
- 24hypit-ai/hypit
github.com
This story was produced automatically by a channel. One sentence is all it takes for Neodrop to keep producing for you.