io.github.Airta-Admin/davinc-resolve-local-bridge-mcp
Davinc-Resolve-Local-Bridge-MCP
这是什么?
Davinc-Resolve-Local-Bridge-MCP 是一个 Model Context Protocol (MCP) 服务器,让 AI 助手能够完全控制 DaVinci Resolve。它提供 215 个工具,覆盖整个 Resolve 脚本 API——项目、时间线、媒体、Fusion、调色、渲染等。
工作原理
Your AI Assistant (Claude, Cursor, Devin, etc.)
│
│ talks MCP (stdio)
▼
mcp_server/server.py ← runs on your machine
│
│ talks HTTP (localhost:8787)
▼
Bridge-Connection-Script.py ← runs INSIDE DaVinci Resolve
│ (Workspace > Scripts menu)
▼
DaVinci Resolve API ← full read + write access桥接脚本在 DaVinci Resolve 进程内部运行,使其能够完全访问 Resolve 脚本 API——即使在 Free 版(该版本会阻止外部脚本)上也是如此。MCP 服务器作为独立进程运行,并通过 localhost HTTP 将工具调用代理到桥接器。
Related MCP server: resolve-mcp
快速开始
前置要求
DaVinci Resolve 18.5+(Free 或 Studio)
你的机器上安装 Python 3.10+
兼容 MCP 的 AI 助手(Claude Desktop、Cursor、Devin 等)
第 1 步 — 安装桥接脚本
运行安装程序:
python install.py或者手动将 bridge/Bridge-Connection-Script.py 复制到 Resolve 的脚本文件夹:
平台 | 路径 |
Windows |
|
macOS |
|
Linux |
|
第 2 步 — 安装 MCP 服务器依赖
pip install -r requirements.txt第 3 步 — 配置你的 AI 助手
将 MCP 服务器添加到你的助手配置文件中。服务器路径是本仓库中的 mcp_server/server.py。
Claude Desktop
编辑 claude_desktop_config.json:
{
"mcpServers": {
"davinci-resolve-local-bridge": {
"command": "python",
"args": ["C:/path/to/Davinc-Resolve-Local-Bridge-MCP/mcp_server/server.py"]
}
}
}Cursor
编辑 .cursor/mcp.json:
{
"mcpServers": {
"davinci-resolve-local-bridge": {
"command": "python",
"args": ["C:/path/to/Davinc-Resolve-Local-Bridge-MCP/mcp_server/server.py"]
}
}
}Devin
编辑 mcp_config.json:
{
"mcpServers": {
"resolve-local-bridge": {
"command": "python",
"args": ["C:/path/to/Davinc-Resolve-Local-Bridge-MCP/mcp_server/server.py"]
}
}
}Claude Code
claude mcp add davinci-resolve-local-bridge -- python C:/path/to/Davinc-Resolve-Local-Bridge-MCP/mcp_server/server.py任意 MCP 客户端(通用)
服务器使用 stdio 传输。使用以下命令启动:
python mcp_server/server.py第 4 步 — 在 DaVinci Resolve 中启动桥接器
打开 DaVinci Resolve
转到 Workspace → Scripts → Bridge-Connection-Script
在 Console(Workspace → Console)中查看:
[Resolve Bridge] Connected to Resolve 21.0.4.5
[Resolve Bridge] HTTP server running on http://127.0.0.1:8787
[Resolve Bridge] 215 actions available第 5 步 — 开始使用
向你的 AI 助手提问:
"检查 DaVinci Resolve 是否已连接"
助手将调用 resolve_status 工具并返回结果。然后尝试:
"创建一个名为 'My Video' 的 1920x1080 30fps 新项目并添加时间线"
架构
桥接脚本(bridge/Bridge-Connection-Script.py)
一个通过 Workspace > Scripts 菜单在 DaVinci Resolve 内部运行的 Python 脚本。它:
从 Fusion 的全局变量中获取实时的
resolve对象在
127.0.0.1:8787上启动 HTTP 服务器提供 3 个端点:
GET /health— 检查桥接器是否存活GET /actions— 列出所有可用的操作名称POST /action— 按名称执行操作并传入参数
通过阻塞式
serve_forever()调用保持运行启动前会终止同一端口上的任何先前实例
MCP 服务器(mcp_server/server.py)
一个独立的 MCP 服务器,它:
通过 localhost 上的 HTTP 连接到桥接器
从桥接器的
/actions端点自动发现全部 215 个操作将每个操作作为带有
resolve_前缀的 MCP 工具公开通过
POST /action将工具调用代理到桥接器与桥接器保持同步——无需手动定义工具
全部 215 个工具
MCP 服务器从桥接器自动发现工具。每个工具都带有 resolve_ 前缀(例如,status 变为 resolve_status)。通过 params 对象传递参数。
Resolve 应用程序(15 个工具)
工具 | 参数 | 描述 |
| — | 检查桥接连接状态并获取当前项目/时间线信息 |
| — | 获取 Resolve 版本信息 |
| — | 获取当前活动页面(edit、cut、color 等) |
|
| 切换到指定页面:edit、cut、fusion、color、fairlight、deliver、media |
| — | 列出可用的布局预设 |
|
| 按名称加载布局预设 |
| — | 获取当前关键帧模式 |
|
| 设置关键帧模式 |
| — | 列出 Fairlight 音频预设 |
| — | 列出烧录预设 |
|
| 从文件导入渲染预设 |
|
| 将渲染预设导出到文件 |
| — | 切换到 Fusion 页面 |
| — | 切换到 Edit 页面 |
| — | 切换到 Deliver 页面 |
项目管理器(18 个工具)
工具 | 参数 | 描述 |
|
| 创建新项目 |
|
| 加载现有项目 |
| — | 保存当前项目 |
| — | 关闭当前项目 |
|
| 删除项目 |
|
| 创建项目文件夹 |
|
| 删除项目文件夹 |
| — | 列出当前文件夹中的项目 |
| — | 列出当前文件夹中的子文件夹 |
| — | 获取当前文件夹名称 |
|
| 打开文件夹 |
| — | 导航到根文件夹 |
| — | 导航到父文件夹 |
|
| 导入 .drp 项目 |
|
| 将项目导出为 .drp |
|
| 归档项目 |
| — | 获取当前数据库名称 |
| — | 列出可用数据库 |
项目设置(7 个工具)
工具 | 参数 | 描述 |
| — | 获取当前项目名称 |
|
| 重命名当前项目 |
|
| 按键获取项目设置 |
|
| 设置项目设置 |
| — | 获取所有项目设置 |
| — | 列出项目预设 |
|
| 应用项目预设 |
媒体存储(4 个工具)
工具 | 参数 | 描述 |
| — | 列出已挂载的存储卷 |
|
| 列出路径中的子文件夹 |
|
| 列出文件夹中的文件 |
|
| 在操作系统文件浏览器中显示文件 |
媒体池(13 个工具)
工具 | 参数 | 描述 |
|
| 将媒体文件导入媒体池 |
| — | 列出根文件夹中的所有片段 |
| — | 获取根文件夹信息 |
|
| 创建子文件夹 |
|
| 设置当前文件夹 |
|
| 从媒体池中删除片段 |
|
| 将片段移动到文件夹 |
|
| 重新链接片段 |
|
| 取消链接片段 |
|
| 导出元数据 CSV |
| — | 列出选中的片段 |
|
| 选择片段 |
|
| 添加遮罩文件 |
时间线(21 个工具)
工具 | 参数 | 描述 |
|
| 创建新的空时间线 |
|
| 从片段创建时间线 |
| — | 列出所有时间线 |
| — | 获取当前时间线名称 |
|
| 重命名当前时间线 |
|
| 按索引切换时间线(从1开始) |
| — | 复制当前时间线 |
|
| 删除时间线 |
| — | 获取起始帧 |
| — | 获取结束帧 |
| — | 获取起始时间码 |
|
| 设置起始时间码 |
| — | 获取当前时间码 |
|
| 设置当前时间码 |
| — | 检测场景剪切 |
|
| 自动生成字幕 |
|
| 导出时间线 |
|
| 从文件导入时间线 |
|
| 将片段追加到时间线 |
|
| 获取时间线设置 |
|
| 设置时间线设置 |
时间线轨道(11个工具)
工具 | 参数 | 描述 |
|
| 统计轨道数量(视频/音频/字幕) |
|
| 添加轨道 |
|
| 删除轨道 |
|
| 启用/禁用轨道 |
|
| 检查轨道是否启用 |
|
| 锁定/解锁轨道 |
|
| 检查轨道是否锁定 |
|
| 获取轨道名称 |
|
| 设置轨道名称 |
|
| 列出轨道上的片段 |
| — | 列出选中的时间线片段 |
时间线片段(66个工具)
所有片段操作都接受可选的 trackType、trackIndex、itemIndex 来定位特定片段,如果省略则作用于第一个选中的片段。
Tool | Parameters | Description |
|
| 获取片段名称 |
|
| 重命名片段 |
|
| 获取片段时长 |
|
| 获取片段起始帧 |
|
| 获取片段结束帧 |
|
| 获取片段属性 |
|
| 设置片段属性 |
|
| 检查片段是否启用 |
|
| 启用/禁用片段 |
|
| 设置片段颜色 |
|
| 获取片段颜色 |
|
| 清除片段颜色 |
|
| 添加标记 |
|
| 获取标记 |
|
| 清除标记 |
|
| 添加标记点 |
|
| 获取标记点 |
|
| 插入生成器 |
|
| 插入 Fusion 生成器 |
| — | 插入 Fusion 合成 |
|
| 插入 OFX 生成器 |
|
| 插入标题 |
|
| 插入 Fusion 标题 |
| — | 从当前帧抓取静帧 |
| — | 从所有片段抓取静帧 |
|
| 创建复合片段 |
| — | 创建 Fusion 片段 |
|
| 导入到时间线 |
|
| 稳定片段 |
|
| 智能重构片段 |
|
| 创建 Magic Mask |
|
| 重新生成 Magic Mask |
|
| 获取片段的轨道信息 |
|
| 获取关联项 |
|
| 设置 CDL 值 |
|
| 添加一个 take |
|
| 统计 take 数量 |
|
| 选择 take |
|
| 完成当前 take |
|
| 将调色复制到其他片段 |
|
| 导出 LUT |
|
| 设置颜色输出缓存 |
|
| 设置 Fusion 输出缓存 |
|
| 获取片段元数据 |
|
| 设置片段元数据 |
|
| 获取片段属性 |
|
| 设置片段属性 |
|
| 链接代理媒体 |
| — | 取消链接代理媒体 |
|
| 用文件替换片段 |
|
| 添加片段标记点 |
| — | 获取片段标记点 |
|
| 设置片段颜色(媒体池) |
|
| 添加片段标记 |
|
| 转录音频 |
|
| 设置入点/出点 |
|
| 清除入点/出点 |
|
| 添加时间线标记点 |
| — | 获取时间线标记点 |
|
| 按颜色删除标记点 |
|
| 删除指定帧的标记点 |
|
| 将当前帧导出为静帧 |
|
| 应用 Fairlight 预设 |
| — | 列出快速导出预设 |
Fusion 合成(14 个工具)
Tool | Parameters | Description |
|
| 创建 Fusion 合成 |
|
| 向片段添加 Fusion 合成 |
|
| 导入 .comp 文件 |
|
| 导出 Fusion 合成 |
|
| 按名称加载合成 |
|
| 按名称删除合成 |
|
| 重命名合成 |
|
| 统计片段上的 Fusion 合成数量 |
|
| 列出 Fusion 合成名称 |
| — | 获取当前 Fusion 合成 |
| — | 列出所有打开的合成 |
| — | 创建新的 Fusion 合成 |
|
| 保存当前合成 |
|
| 加载合成文件 |
| — | 关闭当前合成 |
| — | 渲染当前合成 |
Fusion 工具(11 个工具)
工具 | 参数 | 描述 |
| — | 列出当前合成中的所有工具/节点 |
|
| 按名称查找工具 |
|
| 删除工具 |
|
| 获取工具属性 |
|
| 设置工具属性 |
|
| 添加节点(Background、Paint、Merge 等) |
|
| 连接两个节点 |
|
| 设置节点输入(可设置关键帧) |
|
| 获取节点输入值 |
|
| 设置当前帧 |
| — | 获取当前帧 |
画廊(4 个工具)
工具 | 参数 | 描述 |
| — | 列出画廊静帧相册 |
| — | 列出 PowerGrade 相册 |
| — | 创建静帧相册 |
| — | 创建 PowerGrade 相册 |
调色 / 节点(7 个工具)
工具 | 参数 | 描述 |
| — | 获取当前片段的节点数量 |
|
| 获取节点标签 |
|
| 获取节点的 LUT |
|
| 在节点上设置 LUT |
|
| 启用/禁用节点 |
| — | 重置所有调色 |
| — | 刷新 LUT 列表 |
渲染(22 个工具)
工具 | 参数 | 描述 |
| — | 列出渲染格式 |
|
| 列出某格式的编解码器 |
| — | 获取当前格式/编解码器 |
|
| 设置渲染格式和编解码器 |
| — | 获取渲染模式 |
|
| 设置渲染模式 |
|
| 列出渲染分辨率 |
| — | 列出渲染预设 |
|
| 加载渲染预设 |
|
| 保存新的渲染预设 |
|
| 删除渲染预设 |
|
| 设置渲染设置(TargetDir、CustomName 等) |
| — | 添加渲染任务 |
|
| 删除渲染任务 |
| — | 删除所有渲染任务 |
| — | 列出渲染任务 |
|
| 开始渲染 |
| — | 停止渲染 |
| — | 检查是否正在渲染 |
|
| 获取渲染任务状态 |
|
| 快速导出 |
|
| 添加任务并开始渲染 |
语音与字幕(1 个工具)
工具 | 参数 | 描述 |
|
| 生成 AI 语音音频 |
特殊(1 个工具)
工具 | 参数 | 描述 |
|
| 创建手绘动画(Daniel Batal 技法) |
故障排除
Bridge 无法启动
确保 DaVinci Resolve 正在运行且已打开项目
检查控制台(工作区 → 控制台)中的错误消息
重启 DaVinci Resolve——它只在启动时扫描 Scripts 文件夹
“无法连接到 Resolve Bridge”
确保你已在 Resolve 中运行 工作区 → 脚本 → Bridge-Connection-Script
检查控制台是否显示
[Resolve Bridge] HTTP server running on http://127.0.0.1:8787如果端口已被占用,请关闭 Resolve 并重新打开(过期的
fuscript.exe进程可能占用端口)
工具返回错误
先调用
resolve_status验证连接某些操作需要打开项目、存在时间线或选中片段
Bridge 返回的错误消息会指出缺少什么
技术细节
Bridge 端口: 127.0.0.1:8787(仅限本机,无外部访问)
传输方式: HTTP/1.0,使用 Connection: close
MCP 传输方式: stdio
依赖项:
mcp、requests(仅 MCP 服务器;Bridge 使用纯标准库)Resolve 版本: 18.5+(已在 21.0.4.5 上测试)
Python: MCP 服务器需要 3.10+;Bridge 使用 Resolve 内置的 Python
许可证
MIT 许可证——参见 LICENSE 文件。
致谢
由 The Geek Gods 创建。灵感来自 DaVinci Resolve 脚本社区。
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceExposes 20 tools for project, media, render, and timeline control in DaVinci Resolve 18+ via stdio MCP, enabling AI agents to operate the software through natural language.51MIT
- AlicenseNot gradedqualityFmaintenanceComprehensive MCP server for DaVinci Resolve with 295+ tools to control projects, timelines, editing, color grading, rendering, and more via natural language.3MIT
- AlicenseBqualityDmaintenanceEnables AI-driven DaVinci Resolve 21 automation with 88 tools for project management, timeline editing, color grading, AI analysis, rendering, and dailies creation.882MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that exposes the complete DaVinci Resolve scripting API, enabling AI assistants to control DaVinci Resolve programmatically with over 440 tools for project management, timeline editing, color grading, rendering, and more.5MIT
Related MCP Connectors
OCR, transcription, file extraction, and image generation for AI agents via MCP.
A real timeline video editor for AI agents: journaled edits, FFmpeg/MLT rendering, exports
MCP server for Clipkit — gives AI agents a video toolbox via the Clipkit schema.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Airta-Admin/Davinc-Resolve-Local-Bridge-MCP'
If you have feedback or need assistance with the MCP directory API, please join our Discord server