samuelgursky/davinci-resolve-mcp

这是什么

davinci-resolve-mcp 是一座桥梁，让AI助手（如Claude）能够直接控制 DaVinci Resolve——一款专业的视频编辑和调色应用程序。它实现了 模型上下文协议（MCP）——一种AI工具连接外部软件的标准方式——因此AI可以执行真实的编辑任务：打开项目、构建时间线、添加剪辑、调整颜色、设置渲染等。

工作原理

DaVinci Resolve自带官方 脚本API，允许外部程序控制它。本项目将该API封装为AI助手可以调用的MCP“工具”。当你要求AI“从当前媒体池中的所有剪辑创建一个名为‘Assembly Cut’的时间线”时，AI会通过此服务器将其转换为一系列API调用。

它提供两种模式：

• 复合模式（默认）：37个工具，将相关操作分组，保持AI上下文使用量低
• 完整/细粒度模式：390个工具，每个Resolve API方法一个，适合高级用户

还有一个 高级离线服务器（Node.js），可以在 不运行 Resolve的情况下工作——它直接读取和编辑Resolve项目文件（.drp、.drt、.drx），支持基于云的调色、质量控制和流水线自动化。

主要特性

• 完整编辑控制：媒体池管理、时间线编辑、调色、Fusion合成、音频/Fairlight、渲染设置、审阅标记
• 媒体分析：检测同步事件（2-pop、场记板拍板）、分析剪辑、将元数据写回Resolve
• 安全边界：每个工具返回结构化结果，包含状态、验证（读回是否确认更改？）和语义差异——因此AI代理知道操作是否实际成功
• 执行追踪：多步骤AI操作记录为统一追踪，让编辑者审计AI 为什么 这样做
• 免费版支持：Blackmagic将外部脚本限制在付费的Studio版本，但本项目包含一个应用内桥接脚本，可绕过该限制用于免费版（在Resolve 21.0.x上）
• 本地控制面板：基于浏览器的UI，用于检查Resolve状态和分析结果
• 客户端支持：自动配置Claude Desktop、Cursor、VS Code、Windsurf、Zed以及许多其他AI编码工具

为什么重要

这是 AI代理操作专业创意软件 的实际示例——不仅仅是聊天，而是在错误代价高昂的工具中做真实工作。对验证、审计追踪和受保护操作（破坏性操作前检查）的强调，展示了如何让代理式AI在生产环境中足够安全。离线文件级服务器也展示了AI流水线如何在云中工作，而无需运行桌面应用。