DaVinci Resolve MCP 评测：让 AI 直接操作剪辑时间线的 Python 服务器

它解决什么问题

DaVinci Resolve 的官方 Scripting API 功能强大，但用起来门槛不低。你需要写 Python 脚本，自己处理进程通信，还要在 Resolve 的脚本菜单和外部进程之间来回切换。这个 MCP 服务器把 API 包装成 AI 助手能直接调用的工具，让 Claude Desktop、Cursor、VS Code 这些客户端通过自然语言指令就能控制 Resolve。它面向的是剪辑师、调色师和自动化脚本爱好者，尤其是那些已经用 MCP 生态的人。项目提供两种工具集：默认的复合模式有 36 个工具，把相关操作分组以减少上下文消耗；完整模式有 353 个工具，每个 Resolve API 方法对应一个工具，适合需要精细控制的用户。

工作机制：从外部脚本到循环回环桥接

服务器通过 Resolve 的官方 Scripting API 工作，外部脚本用 scriptapp("Resolve") 获取对象。但 Blackmagic 把外部脚本限制在 Studio 版本，免费版会拒绝外部进程。项目用了一个变通方法：Resolve 的 Workspace > Scripts 菜单不受此限制，脚本从那里启动时能拿到活着的 resolve 对象。于是服务器附带一个桥接脚本，在 Resolve 内部运行，通过带 HMAC 签名和一次性 nonce 的循环回环监听器把对象重新导出。这个桥接在外部脚本不可用时自动启用，也可以用 DAVINCI_RESOLVE_BRIDGE=1 强制启用。强制模式的好处是，如果桥接停止响应，错误会明确指向桥接本身，而不是悄悄回退到其他传输方式。

安装与配置：一条命令，多个客户端

安装入口是 npx davinci-resolve-mcp setup。这个 npm 启动器会在用户应用数据目录装一份受管副本，然后运行通用的 Python 安装器。安装器会创建虚拟环境、检测 Resolve 路径，并自动配置 Claude Desktop、Claude Code、Cursor、VS Code、Windsurf、Zed、Continue、Cline、Roo Code、OpenCode、Codex CLI 和 JetBrains IDE。源码安装则是 git clone 后运行 python install.py。启动服务器前，需要在 Resolve 的 Preferences > General > External scripting using 里设为 Local。免费版用户需要额外运行 python scripts/install_resolve_bridge.py，重启 Resolve，打开项目，然后从 Workspace > Scripts 菜单运行 resolve_bridge。控制面板用 venv/bin/python -m src.control_panel 启动，它只监听循环回环，URL 里带一次性访问令牌，没有令牌的请求会被拒绝。

免费版桥接的坑：macOS 的 Python 路径问题

桥接脚本在 macOS 上有个明显的坑。Resolve 只从两个地方找 Python 3：PYTHON3HOME 环境变量，然后是 /usr/local/bin/python3。Homebrew、pyenv、uv 和 conda 安装的 Python 都不在这两个位置，所以脚本会静默地不出现在菜单里。项目文档给出的解法是用 launchctl setenv PYTHON3HOME "$(python3 -c 'import sys; print(sys.prefix)')" 设置环境变量，注意不能用 export，因为 Resolve 从 Dock 启动，看不到 shell 的环境。设置完要重启 Resolve。项目还安装了一个 Lua canary，用来区分 Python 没检测到和文件夹选错这两种情况。这个细节说明 macOS 上桥接不是即插即用的，需要手动干预。

控制面板：浏览器里的状态检查与分析

服务器自带一个本地浏览器控制面板，用于查看 Resolve 状态、运行源安全分析、查看已分析的片段和镜头，还能直接编辑分析输出。启动命令是 venv/bin/python -m src.control_panel，它启动一个仅限循环回环的服务器，并在浏览器打开一个带令牌的 URL。持续运行的分析任务在切片成功后会自动刷新本地搜索索引，手动 Build Index 操作只用于从已有报告重建。这个面板对调试 AI 助手的行为很有用，因为你可以直观看到 Resolve 当前处于什么状态，而不必依赖 MCP 客户端打印的日志。

已知限制与故障模式

免费版桥接是项目最脆弱的环节。文档明确说这是已记录的进程内路径，不是许可证规避，但 Blackmagic 可能关闭它，属于支持到不再支持的服务层。另外，桥接在服务期间会一直占着端口。v2.70.3 之前，Windows 上的桥接可能比 Resolve 活得久，阻塞下一次会话的监听器。如果你用的是旧版本，桥接停止响应时，要检查是否有残留的 fuscript.exe 还占着端口。Windows 路径在 v2.70.1 添加时未经验证，后来靠用户报告才确认。这说明跨平台支持是逐步完善的，不是一次到位。还有一个重要的边界：免费版的外部脚本被拒绝，所以即使设置了 Local 偏好也没用，必须依赖桥接。

替代方案与项目自身的取舍

直接的替代方案是直接写 DaVinci Resolve 的 Python 脚本，从 Workspace > Scripts 菜单运行。这种方式不依赖 MCP 生态，也不需要额外的服务器层，但你必须自己处理所有逻辑，AI 助手无法直接调用。另一个选择是项目自带的 davinci-resolve-advanced-mcp，一个可选的 Node 服务器，它不做 API 层面的操作，而是直接读写 Resolve 文件（.drp、.drt、.drx），应用数据库或 XML 级别的更改。它和主 Python 服务器互补，一个控制活着的 Resolve 实例，一个处理文件级操作。这种分工意味着，如果你只需要离线修改项目文件，用高级服务器可能更合适，但如果你需要实时控制，主服务器是唯一选择。

维护成本与许可

项目采用 MIT 许可证，意味着你可以自由使用、修改和分发，没有明显的法律限制。维护方面，项目有频繁的 release，最近一次是 v2.103.3，但 v2.103.2 的发布说明提到 Windows 安装失败且没有可读内容，这提醒用户升级前要检查 release 说明。安装器和服务器会检查最新 GitHub release，这个检查是尽力而为且有限流的，不会阻塞 MCP 启动。安装器可以提示、稍后提醒、忽略、禁用检查，或者对干净的 git 检出应用选择加入的安全自动更新。如果你用源码安装，自动更新需要手动启用，否则只能手动拉取。跨平台支持依赖用户报告来验证，比如 Windows 和 Linux 的路径，所以升级后最好在目标平台做一次冒烟测试。

编辑结论

如果你使用 DaVinci Resolve Studio 并希望让 Claude、Cursor 等 AI 助手直接操作时间线、媒体池或渲染设置，这个项目值得尝试。免费版用户必须依赖桥接脚本，而 Blackmagic 随时可能关闭这条路径，所以先把桥接在真实项目上跑通，确认它能在你的系统和 Resolve 版本上稳定工作。如果你只需要简单导出或批量操作，官方脚本菜单可能更省事。决定采用前，先检查最新 release 的更新说明，特别是 v2.103.2 提到的 Windows 安装问题是否影响你的环境。

官方来源

1. Official README
2. Project repository
3. Release notes