BAIZE AI RESOURCE

通过 MCP 让 AI 助手驱动 DaVinci Resolve 完成剪辑、调色、音频、Fusion 与交付

davinci-resolve-mcp

通过 MCP 让 AI 助手驱动 DaVinci Resolve 完成剪辑、调色、音频、Fusion 与交付

获取资源
davinci-resolve-mcp

资源介绍

davinci-resolve-mcp 把 DaVinci Resolve 的脚本 API 封装成 MCP 工具，让 Claude Code、Cursor、Codex 等支持 MCP 的 AI 客户端可以直接操作 Resolve。它由两个服务器组成：Python 的 davinci-resolve 服务器连接正在运行的 Resolve，负责时间线剪辑、调色、音频、Fusion 合成、渲染等实时操作；Node 的 davinci-resolve-advanced 服务器无需打开 Resolve，直接读写 .drx/.drp/.drt 文件与项目数据库，用于离线调色计算、conform QC、交付物校验和素材分析。仓库同时内置大量技能文件（resolve-edit、resolve-color、resolve-audio、resolve-conform、resolve-delivery、resolve-fusion 等），把剪辑、调色、音频、套底、交付的工艺规则与 API 版本限制写进 AI 的工作上下文，并强调先看帧再调色、不修改源素材等约束。适合剪辑师、调色师、后期工程师和希望用自然语言批量操作 Resolve 的团队。

MCP 能力

双服务器架构

Python 服务器连接运行中的 Resolve 执行实时操作，Node 服务器在未打开 Resolve 时读写 .drx/.drp/.drt 与项目数据库，实时与离线任务分工明确。

内置工艺技能与版本门控

仓库内置 resolve-audio、resolve-color 等工艺技能文件，为音频、调色等任务提供操作指引，并记录各 API 符号所需的最低 Resolve 版本及缺失时的替代路径。

帧优先的调色约束

调色前要求先查看 Resolve 渲染的代表帧，比较 bypass/current/after，并保留可恢复的调色版本，避免仅凭元数据或风格标签盲目套用。

资源配置

支持客户端

Claude CodeCursorCodex其他 MCP Client

安装方式

NPMPip源码安装

配置方式

JSON配置命令行

运行环境

Node.jsPython本地系统

安装与配置

  1. 在装有 DaVinci Resolve 的工作环境中安装 MCP 服务，并把它加入所用 AI 客户端配置。

  2. 打开要处理的 Resolve 项目，确认 MCP 已连接到正确实例和时间线。

  3. 用自然语言说明剪辑、调色、音频、Fusion 或渲染任务；复杂任务先让 AI 给出操作计划。

  4. 执行前确认素材、轨道和输出位置，并在 Resolve 中预览结果后再保存或渲染交付。

使用案例

按交付目标准备渲染

使用场景需要输出 ProRes 母版或 H.264 网络版

调用 list_delivery_targets 选择 prores422hq_master 或 h264_1080p_web，再用 prepare_delivery_job 生成 Resolve 渲染设置与对应的 deliverable_qc 规格，渲染后按同一规格校验成片。

离线调色匹配

使用场景多机位素材需要统一肤色与曝光

用 advanced 服务器的 drx 工具执行 match_to_reference、skin_match、level_clips 等动作，从帧统计计算调色并写出可应用的 .drx，再由实时服务器 safe_apply_drx 应用到时间线。

套底帧级 QC

使用场景剪辑套底后需要确认每个镜头对位正确

使用 conform 工具的逐切帧 QC，将 oracle 帧与参考渲染对比，识别错误但文件名相似的素材，并可用 color_trace plan 把原调色迁移到新剪辑版本。

包含内容

davinci-resolve-mcp-source.zip
README-中文安装说明.md
LICENSE-MIT.txt
SHA256.txt

常见问题

davinci-resolve-mcp 的离线服务器能做什么，哪些操作必须由在线服务器完成？
davinci-resolve-advanced（Node）服务器可在不打开 Resolve 的情况下读写 .drx/.drp/.drt 文件与项目数据库，负责离线计算调色并写出可应用的 .drx、离线 conform QC、交付物校验、素材分析、离线时间线/变更单（drt、editorial）以及离线 Fusion .comp 编写；而把调色应用到时间线（timeline_item_color.safe_apply_drx）、在运行中的时间线上构建 Fusion comp 等属于 davinci-resolve（Python，在线）服务器的职责，Node 服务器从不驱动 Resolve。
davinci-resolve-mcp 中调色、LUT、CDL、DRX 或复制调色应用到真实时间线前有什么强制要求？
仓库的 AGENTS.md 规定，在把调色、LUT、CDL、DRX 或复制的调色应用到真实时间线前，必须先查看 Resolve 渲染的代表帧（缩略图、联系表、Gallery 静帧或仅写入临时目录的视觉报告），并在 API 允许时对比 bypass/current/after，之后恢复原有版本或节点状态，避免仅凭元数据或风格标签盲目套用。
davinci-resolve-mcp 能通过脚本设置片段速度、倒放或速度斜坡吗？
不能。任何版本都没有片段速度 API，set_retime 只设置变速质量（RetimeProcess、MotionEstimation），设置速度百分比、倒放和速度斜坡都不可达，SetProperty('Speed'|'PlaybackSpeed'|'RetimeSpeed'|'ClipSpeed') 在所有已测版本返回 False。这类操作需要在 Resolve 界面中完成。
davinci-resolve-mcp 能通过脚本控制 Fairlight 混音自动化曲线或插件图吗？
不能。公开 API 不暴露 Fairlight 混音自动化曲线或插件图，任何版本都没有逐参数控制；可用的只有 GetFairlightPresets 与 ApplyFairlightPresetToCurrentTimeline，整体套用已保存的混音，且需要 Resolve 20.2.2 及以上。总线路由没有脚本 API，fairlight 工具通过修改 FLStudioModelBA blob 实现。
davinci-resolve-mcp 的 timeline author_offline 生成时间线文件时默认用哪种格式，有什么需要注意的警告？
timeline author_offline 可在没有连接 Resolve 的情况下，从文件路径片段计划写出可导入的时间线（drt / otio / edl），默认使用 drt（Resolve 原生，项目版本 17 / Resolve 21.0，更旧的构建需要降级 drt）。需要读回警告，其中 media_tc_origin_assumed 最关键：OTIO 源帧是时间码绝对的，缺少 media_start_tc_frame 的事件会导入为一条空时间线且不报任何错误。