DaVinci Resolve MCP Server

DaVinci Resolve MCP 服务器

用于与 DaVinci Resolve 和 Fusion 交互的模型上下文协议 (MCP) 服务器。该服务器允许像 Claude 这样的 AI 助手通过模型上下文协议直接与 DaVinci Resolve 交互并控制它。

特征

• 双向通信：通过 MCP 协议将 Claude AI 连接到 DaVinci Resolve
• 项目管理：创建、打开和管理 DaVinci Resolve 项目
• 时间线操作：创建、修改和导航时间线
• 媒体管理：导入、组织和管理媒体池中的媒体
• Fusion 集成：创建和修改 Fusion 作品
• 场景检查：获取有关当前 DaVinci Resolve 项目的详细信息
• 代码执行：在 Claude 的 DaVinci Resolve 中运行任意 Python 代码

安装

先决条件

• DaVinci Resolve Studio（建议使用 17 或更高版本）
• Python 3.8 或更高版本
• Claude Desktop（用于AI集成）

设置

1. 克隆此存储库：
   git clone https://github.com/apvlv/davinci-resolve-mcp.git cd davinci-resolve-mcp
2. 安装所需的依赖项：
   pip install -r requirements.txt
3. 在 Claude Desktop 中安装 MCP 服务器：
   mcp install src/resolve_mcp/server.py
   或者，您可以使用可编辑标志进行安装以进行开发：
   mcp install src/resolve_mcp/server.py --with-editable .

用法

使用 Claude Desktop

1. 启动 DaVinci Resolve
2. 在 Claude Desktop 中，连接到“DaVinci Resolve MCP”服务器
3. 您现在可以通过 Claude 与 DaVinci Resolve 进行交互

5ire

5ire是一个开源跨平台桌面 AI 助手和 MCP 客户端，与该服务器兼容。

1. 从GitHub安装 5ire 或在 macOS 上使用 Homebrew 安装：
   brew tap brewforge/extras brew install --cask 5ire
2. 启动 DaVinci Resolve
3. 在 5ire 中，添加 DaVinci Resolve MCP 服务器
4. 使用您喜欢的 AI 模型（OpenAI、Claude 等）连接到服务器
5. 您现在可以通过 5ire 与 DaVinci Resolve 进行交互

可用命令

资源（信息检索）

• project://current获取有关当前项目的信息
• project://timelines - 获取当前项目中的时间线列表
• timeline://current获取有关当前时间线的信息
• mediapool://folders - 获取媒体池中的文件夹列表
• mediapool://current - 获取有关当前媒体池文件夹的信息
• storage://volumes - 获取媒体存储中已安装卷的列表
• system://status - 获取 DaVinci Resolve 连接的当前状态

项目管理

• create_project(name) - 创建一个新的 DaVinci Resolve 项目
• load_project(name) - 加载现有的 DaVinci Resolve 项目
• save_project() - 保存当前的 DaVinci Resolve 项目

时间线管理

• create_timeline(name) - 在当前项目中创建一个新的时间线
• set_current_timeline(index) - 通过索引设置当前时间线（从 1 开始）

媒体管理

• import_media(file_paths) -将媒体文件导入当前媒体池文件夹
• create_folder(name) -在当前媒体池文件夹中创建一个新文件夹
• create_timeline_from_clips(name, clip_indices) - 从当前媒体池文件夹中的剪辑创建新的时间线

融合集成

• add_fusion_comp_to_clip(timeline_index, track_type, track_index, item_index) - 将 Fusion 合成添加到时间线中的剪辑
• create_fusion_node(node_type, parameters) - 在当前合成中创建一个特定的Fusion节点
• create_fusion_node_chain(node_chain) - 在当前合成中创建连接的 Fusion 节点链

页面导航

• open_page(page_name) - 在 DaVinci Resolve 中打开特定页面（媒体、编辑、融合、颜色、fairlight、交付）

高级操作

• execute_python(code)任意 Python 代码
• execute_lua(script)

示例

• “创建一个名为‘我的纪录片’的新项目”
• “从下载文件夹导入所有视频文件”
• “使用选定的剪辑创建新的时间线”
• “将 Fusion 效果应用于选定的剪辑”
• “获取有关当前项目的信息”
• “切换到颜色页面”
• “保存当前项目”
• “在媒体池中创建一个名为‘Raw Footage’的文件夹”
• “在当前 Fusion 合成中创建一个模糊节点”
• “创建一个内容为‘Hello World’的文本节点”
• “创建节点链：MediaIn -> Blur -> ColorCorrector -> MediaOut”

技术细节

该服务器使用模型上下文协议 (MCP) 在 Claude 和 DaVinci Resolve 之间进行通信，并利用 DaVinci Resolve 的 Python API 来控制应用程序。

执照

麻省理工学院