← 返回目录
D

DaVinci Resolve MCP Server

社区
用于 DaVinci Resolve Studio 的 MCP 服务器,通过官方脚本 API 实现 AI 助手对后期制作工作流的全面控制。
GitHub 源仓库 ↗
★ 2.3k Stars 分类 · 其他 非常热门 源版本 c3c075bcc930
71FMRS · B
可靠性
9/20
安全与权限
15/20
维护活跃度
16/20
文档质量
18/20
安装易用性
13/20

该 MCP 服务器提供对 DaVinci Resolve Studio 的全面控制,覆盖 100% 的 API 方法,拥有两种模式和高测试覆盖率。它专为专业后期制作设计,强调源媒体安全和操作确认。

查看 FMRS 评分方法 →

这是一个模型上下文协议(MCP)服务器,让 AI 助手能够通过 DaVinci Resolve Studio 的官方脚本 API 控制它。它提供了完整的 API 覆盖(349/349 方法)以及受保护的工作流辅助工具,涵盖编辑、媒体池管理、渲染设置、审阅标记、调色、Fusion、Fairlight、项目生命周期、扩展开发和安全媒体分析。服务器提供两种模式:复合模式(34 个工具,默认,减少上下文占用)和完整/精细模式(341 个工具,每个 API 方法对应一个工具)。还包括一个可选的离线高级服务器(18 个工具),可在不运行 Resolve 的情况下处理 .drp/.drt/.drx 文件和数据库操作。

工具能力

app_control
管理 Resolve 应用连接、页面切换、项目 CRUD、数据库和设置。
media_pool
安全导入媒体、管理媒体池、整理分箱、元数据归一化和分析。
timeline_editing
创建和编辑时间线,处理剪辑、轨道、范围、间隙和合片操作。
media_analysis
对媒体文件进行源安全分析,包括同步标记检测、转录、视觉分析和元数据写回。
review_markers
添加、复制和管理时间线/项目标记,生成审阅报告。
color_grading
检查节点图、验证 CDL、管理版本、预设和画廊剧照。
fusion
创建和管理 Fusion 合成、工具和连接。
audio
检查音频轨道和属性,支持语音隔离和自动同步。
render_deliver
配置渲染设置、验证格式和编解码器、管理渲染队列。
extension_authoring
帮助安装/移除 Fuse、DCTL 和 Lua/Python 脚本扩展。

安装接入

  1. 打开 DaVinci Resolve Studio(18.5+),在偏好设置 > 常规 > 外部脚本使用中选择“本地”。2. 运行 npx davinci-resolve-mcp setup 或克隆仓库并运行 python install.py。3. 安装程序会配置 Claude Desktop、Claude Code、Cursor、VS Code 等客户端。4. 对于免费版,运行 python scripts/install_resolve_bridge.py 并设置 DAVINCI_RESOLVE_BRIDGE=1
claude_desktop_config.json
{
  "mcpServers": {
    "davinci-resolve": {
      "command": "<python>",
      "args": [
        "<path>/src/server.py"
      ]
    }
  }
}

选型与风险

适合谁

  • 视频编辑和后期制作专业人士
  • 使用 DaVinci Resolve Studio 的调色师
  • 需要自动化工作流的助理编辑
  • 希望集成 AI 助手进行媒体管理的团队

不适合谁

  • 完全依赖免费版 DaVinci Resolve 的用户(需要桥接,可能不稳定)
  • 需要网络服务或有服务器端部署的用户(仅限本地 stdio)
  • 希望自动选择最佳镜头的用户(该功能不提供)
  • 希望自动切割音乐的用户(该功能不提供)

所需权限

  • 启动和控制 DaVinci Resolve 应用
  • 读取和写入 Resolve 项目数据库
  • 读取和写入本地媒体文件(分析时)
  • 执行破坏性操作(需确认)
  • 执行外部命令(如 ffmpeg)

风险与副作用

  • 可能修改项目数据,请确保备份
  • 分析工具不会修改源媒体,但可能写入元数据
  • 破坏性操作需谨慎
  • 免费版桥接可能被 Blackmagic 关闭

常见排障

  1. 检查 Resolve 是否设置为“本地”脚本
  2. 确认 Python 版本为 3.10-3.12(或更高版本兼容)
  3. 运行 `python scripts/doctor.py` 检查依赖
  4. 查看日志和 API 覆盖文档
  5. 如果使用免费版,请确认桥接已安装并运行

使用场景

列出所有项目并打开指定项目
根据当前 bin 中的剪辑创建时间线
构建多机位准备时间线
检测 2-pop 或拍板声以同步
分析时间线中的间隙、重叠和缺失媒体
构建 ProRes 422 HQ 渲染计划
将审阅标记从时间线复制到剪辑
创建 Fusion TextPlus 覆盖层

支持客户端

Claude Desktop完整支持
Claude Code完整支持
Cursor完整支持
VS Code完整支持
Windsurf完整支持
Zed完整支持
Continue完整支持
Cline完整支持
Roo Code完整支持
OpenCode完整支持
JetBrains IDEs完整支持