DaVinci Resolve MCP · 安装

安装 DaVinci Resolve MCP

DaVinci Resolve MCP 是一个运行在您计算机上的服务器，由您的 MCP 客户端（Claude Desktop、Cursor、Claude Code、Codex）启动。您可以使用 Synthetic Setup 进行安装。它通过您在 Resolve 内部加载的一个小型连接器与 DaVinci Resolve 通信。它支持 Windows。macOS 为测试版：尚未经过完整测试，可能存在错误。在 Windows 上与服务器一起安装的 Synthetic 窗口可以通过一个按钮为您加载连接器（步骤 5）。

要求

1. 使用 Synthetic Setup 进行安装

从 /dashboard/downloads 下载 Synthetic Setup 并运行。它会自动检测您的 MCP 客户端 (Claude Desktop, Cursor, Claude Code, Codex)，并将 DaVinci Resolve MCP 添加到其中，同时自动加载您的许可证。完成后，它会显示您在步骤 3 中需要粘贴到 DaVinci Resolve 的代码行。

更倾向于手动编辑客户端配置？MCP 客户端设置指南 显示了具体的条目内容。

2. 重启您的 MCP 客户端

退出您的 MCP 客户端并重新打开：服务器在启动时加载。首次运行时，服务器将在几秒钟内完成下载，并在验证您的许可证后，在您的计算机上创建 DaVinci Resolve 连接器。

3. 在 DaVinci Resolve 中加载连接器

打开带有项目的 DaVinci Resolve。前往 Workspace → Console，在 Console 顶部选择 Lua，然后粘贴适用于您系统的代码行，并将 YOUR_USER 替换为您在该电脑上的用户名：

Windows

dofile([[C:\Users\YOUR_USER\.synthetic\davinci-resolve-mcp\bridge\synthetic_server.lua]])

macOS

dofile([[/Users/YOUR_USER/.synthetic/davinci-resolve-mcp/bridge/synthetic_server.lua]])

Console 将显示连接器已就绪，且 Resolve 继续正常运行。每个 Resolve 会话需执行一次此操作：在关闭并重新打开 Resolve 后，请再次粘贴该行代码。

4. 试用

在 Resolve 处于打开状态且连接器已加载的情况下，向您的 MCP 客户端尝试发送一个简单的指令：

如果它能回答出您的项目和时间轴信息，说明一切运行正常。接着可以尝试更复杂的操作：添加标记、应用 LUT 或渲染时间轴。

5. Synthetic 窗口

Synthetic DaVinci Resolve MCP 窗口会显示 Resolve 是否已连接，并提供 连接 按钮，可为您打开 Resolve 的 Console 并加载连接器。电脑上需要安装 Node.js（与 MCP 客户端使用的是同一个）。如果 连接 无法完成，手动连接 会显示需要粘贴的代码行。在 Windows 上，Synthetic Setup 会将它与服务器一起安装：您可以在开始菜单中找到「Synthetic DaVinci Resolve MCP」。您也可以从 /dashboard/downloads 下载。

• Windows：Synthetic Setup 会为您安装；如果您手动下载了安装程序，请运行它。由于该程序尚未签名，Windows 可能会显示 SmartScreen 警告：请点击“更多信息”，然后点击“仍要运行”。
• macOS：根据您的 Mac 芯片（Apple Silicon (M1 及更新版本) 或 Intel）下载对应的 .dmg 文件，并将应用拖入“应用程序”文件夹。该应用尚未经过 Apple 签名：首次运行时，请右键点击应用并选择“打开”。如果 macOS 仍然拒绝运行，请前往“系统设置”→“隐私与安全性”，然后点击“仍要打开”。

在 Mac 上，连接 需要“辅助功能”权限才能在 Resolve 的 Console 中输入代码行：前往“系统设置”→“隐私与安全性”→“辅助功能”→ 打开“Synthetic DaVinci Resolve MCP”（macOS 可能还会要求允许它控制 System Events）。如果您不想授予此权限，请使用 手动连接：Workspace → Console，Lua 模式，粘贴步骤 3 中的代码行，每个 Resolve 会话一次。