企业官网建设流程全解析

davinci-resolve-mcp接入清单：让Claude Desktop、Cursor、VS Code一键指挥你的剪辑时间线

【免费下载链接】davinci-resolve-mcpMCP server integration for DaVinci Resolve Studio项目地址: https://gitcode.com/gh_mirrors/da/davinci-resolve-mcp

davinci-resolve-mcp是一个面向 DaVinci Resolve Studio 的 MCP server（模型上下文协议服务器），它把剪辑软件的官方脚本 API 封装成 AI 助手可以直接调用的工具——接入后，你在 Claude Desktop、Cursor 或 VS Code 里用一句自然语言，就能指挥你的剪辑时间线：建时间线、整理素材、渲染交付、打审片标记、调色、做音频和 Fusion 合成，全程无需在界面里点来点去。

下面这份清单帮你 5 分钟内完成接入。

📋 接入前准备：3 个前置条件

在动手之前，请对照确认以下 3 项，这是最常见的接入失败原因：

详细的环境要求与平台路径见安装文档：docs/install.md。

🚀 最快接入方法：一条命令装好全部

前置条件就绪后，先启动 DaVinci Resolve Studio，然后在终端运行：

npx davinci-resolve-mcp setup

这条命令会自动完成：在你的用户目录下安装受管副本 → 创建虚拟环境 → 自动检测本机 Resolve 安装路径 → 配置 MCP 客户端，一步到位，装完后客户端直接指向本地 Python 环境，连 Node 都不用常驻。

更喜欢源码方式的话：

git clone https://gitcode.com/gh_mirrors/da/davinci-resolve-mcp cd davinci-resolve-mcp python install.py

安装器入口是 install.py，支持按客户端精确配置，例如：

python install.py --clients cursor,claude-desktop # 只配置这两个 python install.py --clients all # 配置全部受支持客户端

✅ 客户端支持清单：一次接入，多处生效

安装器可自动写入配置，覆盖 13 类 MCP 客户端，你最关心的三大主力都在其中：

配完之后用 doctor 做一次体检，它会以 dry-run 方式检查环境、Resolve 连接和客户端配置是否都就位：

npx davinci-resolve-mcp doctor

也可以直接读 scripts/doctor.py 了解它检查了哪些项。

🧪 接入验证：让 AI 说第一句话

在任一已配置的客户端里输入：

"List all projects and open the one called 'My Film'"

AI 通过 davinci-resolve-mcp 返回项目列表并打开指定项目，说明整条链路已经打通。默认接入的是Compound 模式（src/server.py，37 个聚合工具，上下文占用低、响应干净）；高级用户可切换到 Full 模式（src/resolve_mcp_server.py，389 个"一个 API 一个工具"的细粒度工具）。

🎬 接入后能做什么：剪辑工作流交给对话

官方给出的真实用例，感受一下自然语言驱动剪辑时间线的幅度（摘自 README.md）：

• 🎞️"用当前 bin 的所有片段建一条叫 Assembly Cut 的时间线"
• 📷"从选中的多个机位素材构建多机位预备时间线"
• 🔍"探测这条时间线的空隙、重叠和缺失媒体"
• 🏷️"把审片标记从时间线复制到选中片段，并导出审片报告"
• 🎨"快照这个片段的调色，校验 CDL 更新并导出临时 LUT"
• 📤"生成 ProRes 422 HQ 渲染计划，校验设置并加入渲染队列"
• ✍️"在选中片段上创建 Fusion 文字图层并校验节点连接"

完整能力矩阵（媒体池、时间线、调色、Fairlight 音频、Fusion、渲染交付、扩展开发）可在 docs/reference/api-coverage.md 中逐条查看。

🖥️ 本地控制面板：接入状态一眼看穿

davinci-resolve-mcp 还内置了一个仅绑定本机的浏览器控制面板，用于检查 Resolve 连接状态、查看已分析片段、审查 AI 生成的剪辑计划。三种方式任选一种打开：

npx davinci-resolve-mcp control-panel # npm 包方式 # 或 venv/bin/python -m src.control_panel # 源码方式

也可以直接在聊天里对 AI 说"打开这个仓库的 Resolve MCP 控制面板"。完整面板导览见 docs/guides/control-panel.md。

Edit Plans 页面会把 AI 生成的"干跑"剪辑计划存档，你在网页里复核，确认后再回到聊天中执行——改 34 个镜头、约 169 秒的新时间线，就是这么被管理的：

AI Console 页面则负责驱动 Resolve 本地 AI 能力（去模糊、语音生成、音频分类等），并内置了分级的用量治理策略，防止误操作产生大量媒体文件：

❓ 常见问题：免费版能用吗？

能，但要走应用内桥接。Blackmagic 把外部脚本权限限定给了 Studio 版：免费版上scriptapp("Resolve")会拒绝外部进程。不过 Resolve 21.0.x 的Workspace ▸ Scripts菜单未受限，davinci-resolve-mcp 提供了一个在 Resolve 内部运行、通过带鉴权的本机回环通道把控制权导出给 MCP server 的桥接脚本：

python scripts/install_resolve_bridge.py # 重启 Resolve，打开项目后：Workspace > Scripts > resolve_bridge

注意 21.1 起免费版已把 Python 脚本移出菜单，该桥接目前按 21.0.x 路径对待。桥接实现见 scripts/install_resolve_bridge.py，安全模型（仅回环、HMAC 签名、一次性 nonce）说明在 SECURITY.md。

其他高频问题：

• Python 版本踩坑？3.13/3.14 可用但可能触发老版本 Resolve 的桥接加载失败；若连接检查报错，装一个 3.10–3.12 并用DAVINCI_RESOLVE_MCP_PYTHON指过去即可。
• 远程控制？把脚本模式切到Network并设置RESOLVE_SCRIPT_HOST，MCP server 会用带超时的显式 IP 连接；生产环境建议保持 Local。

📚 延伸阅读

• 安装与手工配置全文：docs/install.md
• 控制面板完整导览：docs/guides/control-panel.md
• API 覆盖率与实测数据：docs/reference/api-coverage.md
• 无头（headless）运行能力矩阵：docs/reference/headless-capability-matrix.md

【免费下载链接】davinci-resolve-mcpMCP server integration for DaVinci Resolve Studio项目地址: https://gitcode.com/gh_mirrors/da/davinci-resolve-mcp