davinci-resolve-mcp MCP — 使用场景, 安装 & 实时演示

为什么要用

核心特性

27 个工具覆盖全部 324 个 Resolve API 方法（100%）
通用安装器自动配置 Claude Desktop/Code、Cursor、VS Code、Windsurf、Zed、JetBrains
时间线操作：轨道、标记、剪辑、生成器、字幕
单剪辑变换、裁切、合成、重新定时、关键帧
用于动画制作自动化的 Fusion 节点图 API

实时演示

实际使用效果

davinci-resolve.replay ▶ 就绪

0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "davinci-resolve": {
      "command": "uvx",
      "args": [
        "davinci-resolve-mcp"
      ],
      "_inferred": true
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "davinci-resolve": {
      "command": "uvx",
      "args": [
        "davinci-resolve-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "davinci-resolve": {
      "command": "uvx",
      "args": [
        "davinci-resolve-mcp"
      ],
      "_inferred": true
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "davinci-resolve": {
      "command": "uvx",
      "args": [
        "davinci-resolve-mcp"
      ],
      "_inferred": true
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "davinci-resolve",
      "command": "uvx",
      "args": [
        "davinci-resolve-mcp"
      ]
    }
  ]
}

Continue 使用服务器对象数组，而非映射。

~/.config/zed/settings.json

{
  "context_servers": {
    "davinci-resolve": {
      "command": {
        "path": "uvx",
        "args": [
          "davinci-resolve-mcp"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add davinci-resolve -- uvx davinci-resolve-mcp

一行命令搞定。用 claude mcp list 验证，claude mcp remove 卸载。

使用场景

实战用法： davinci-resolve-mcp

从脚本和素材文件夹构建粗剪

👤 制作讲话人物视频的编辑 ⏱ ~20 min intermediate

何时使用： 你有 2 小时素材和 3 页脚本，不想从空白时间线开始

前置条件

打开 DaVinci Resolve Studio 18.5+ — 购买一次（$295）— 免费版没有脚本 API
Resolve 偏好设置：System > General > External scripting using: Local — 切换后重启 Resolve
通过通用安装器安装 MCP — git clone samuelgursky/davinci-resolve-mcp && python install.py

步骤

创建项目并导入媒体

创建新项目 'EP04_RoughCut'（1080p24），并将 ~/Footage/EP04 中的所有 .mov 导入到名为 'B-roll' 的媒体库文件夹中✓ 已复制

→ 项目打开且文件夹已填充
构建与脚本节奏对应的时间线

创建新时间线。对于 ~/Footage/EP04/script.md 中的每一段，在 V2 轨道上添加一个 6 秒标记，标签为前 5 个词✓ 已复制

→ 带有节奏标记的时间线
在每个标记处放置素材

在每个标记处，根据文件名关键词选择最匹配的 B-roll 剪辑，并将其放在 V1 的该标记处✓ 已复制

→ 剪辑明显组装完成

结果： 一个可手动细化的粗剪，5 分钟内完成而不是一小时

注意事项

基于文件名的匹配噪声大 — 用描述性前缀重命名剪辑，或使用 Resolve 内置的语音隔离/转录以实现更智能的匹配
在大项目上运行 MCP 工具时 Resolve 反应迟钝 — 在更小的'组装'项目中工作；稍后再与大项目一致化

搭配使用： filesystem

在整个时间线上批量应用调色预设

👤 做协助工作的调色师 ⏱ ~15 min intermediate

何时使用： 你想在 60 个剪辑上应用基础 LUT 和饱和度调整，然后再开始手动调色

步骤

检查时间线结构

列出活动时间线中的每个剪辑及其入点/出点和源文件名✓ 已复制

→ 剪辑清单
应用预设

对每个剪辑，应用 Power Grade 'EP04_Base' 作为第一个节点✓ 已复制

→ 缩略图更新
标记看起来不对的剪辑

预设应用后哪些剪辑看起来明显超出正常范围？建议按剪辑调整✓ 已复制

→ 需要手动调整的剪辑列表

结果： 在几秒内应用一致的基础调色，带有手动调整标记

从单个时间线导出多个交付物

👤 向 YouTube、Instagram 和广播交付的编辑 ⏱ ~10 min beginner

何时使用： 相同的剪辑，三个导出规格，不想在渲染页面上点击三次

步骤

将三个渲染都加入队列

为活动时间线排队渲染：YouTube 1080p H.264 到 ~/Exports/yt.mp4，Instagram 1080x1350 到 ig.mp4，ProRes 422 HQ 到 broadcast.mov✓ 已复制

→ 渲染队列中有 3 个任务
启动并监控

启动所有排队的任务，完成时报告✓ 已复制

→ 每个任务的完成状态

结果： 一次聊天中的多格式交付

搭配使用： filesystem

组合

与其他 MCP 搭配，撬动十倍杠杆

davinci-resolve + filesystem

从磁盘读取脚本/EDL 并根据它进行剪辑

读取 ~/Project/EP04/edl.txt 并在当前 Resolve 项目中构建匹配的时间线。✓ 已复制

davinci-resolve + after-effects

在 AE 中完成 VFX，然后重新导入 Resolve

AE 渲染完成在 ~/renders/vfx/ 后，使用新文件替换 Resolve 时间线中的对应占位符剪辑。✓ 已复制

工具

此 MCP 暴露的能力

工具	输入参数	何时调用	成本
resolve	action: str, params?: object	应用级别：页面、布局、渲染预设	free (local)
project_manager	action, params	创建/打开/删除项目、数据库、云	free
project	action, params	时间线、渲染管道、设置、LUT	free
media_pool	action, params	导入、组织剪辑和时间线	free
timeline	action, params	轨道、标记、项目、生成器	free
timeline_item	action, params	单剪辑属性、Fusion 合成、版本、CDL	free
timeline_item_transform	item_id, pan?, tilt?, zoom?, rotation?	重新定位/调整剪辑大小	free
timeline_item_keyframes	item_id, property, frame, value	为任何可关键帧化的属性设置动画	free
gallery	action, params	静止画面和 Power Grades	free
fusion_comp	action, params	构建/修改 Fusion 节点图	free

成本与限制

运行它的成本

API 配额: 无网络 — 一切都是本地脚本 API
每次调用 Token 数: 大多数响应 200-800 tokens；大型编辑的时间线导出可能达到 5k
费用: DaVinci Resolve Studio 一次性购买约 $295（必需）。MCP 本身是免费/MIT 的
提示: 成本是 Resolve Studio 和你的渲染时间；API 调用免费。要求范围内的列表（1 个时间线、1 条轨道），而不是整个项目导出

安全

权限、密钥、影响范围

凭据存储： 无凭据 — 仅本地脚本

数据出站： 无。所有 API 调用都留在 Resolve 内

切勿授予： 禁止 MCP 远程网络暴露 — 仅保持本地

启用'External scripting using: Local' — 除非你拥有端到端的网络，否则永远不要选择'Network'
MCP 具有完全的项目控制权；不要在你今天要交付的项目上进行实验

故障排查

常见错误与修复

无法连接到 DaVinci Resolve

Resolve 必须正在运行且'External scripting using: Local'已启用；切换后重启 Resolve

验证： Preferences > System > General shows Local

免费版本：脚本已禁用

免费版本不暴露脚本 API。升级到 Studio

macOS 上 Python 版本不匹配

安装器偏好 Python 3.10-3.12。使用 pyenv install 3.11.9 并重新运行 install.py

验证： python3 --version

4K 项目上的操作超时

Resolve 的脚本 API 是单线程的，并在 UI 更新后排队。在大批量操作期间最小化 Resolve 的查看器面板

替代方案

davinci-resolve-mcp 对比其他方案

替代方案	何时用它替代	权衡
Adobe Premiere MCPs（社区）	你的工作流是 Premiere，而不是 Resolve	Premiere 的 MCP 生态系统不太成熟
After Effects MCP	你做的是动画制作，而不是编辑/调色	管道的不同阶段
原生 Python + Resolve API	你想要完全控制且不需要 AI	没有 MCP = 没有聊天界面

davinci-resolve-mcp