DaVinci Resolve MCP 服务器

一个用于与 DaVinci Resolve 和 Fusion 交互的模型上下文协议 (MCP) 服务器。此服务器允许像 Claude 这样的人工智能助手通过模型上下文协议直接与 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) - 从当前媒体池文件夹中的片段创建一个新的时间线

Fusion 集成

• 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 中打开一个特定的页面（media、edit、fusion、color、fairlight、deliver）

高级操作

• execute_python(code) - 在 DaVinci Resolve 中执行任意 Python 代码
• execute_lua(script) - 在 DaVinci Resolve 的 Fusion 中执行 Lua 脚本

示例

• "创建一个名为 'My Documentary' 的新项目"
• "从 Downloads 文件夹导入所有视频文件"
• "使用选定的片段创建一个新的时间线"
• "将 Fusion 效果应用于选定的片段"
• "获取有关当前项目的信息"
• "切换到 Color 页面"
• "保存当前项目"
• "在媒体池中创建一个名为 'Raw Footage' 的文件夹"
• "在当前 Fusion 合成中创建一个 Blur 节点"
• "创建一个内容为 'Hello World' 的 Text 节点"
• "创建一个节点链：MediaIn -> Blur -> ColorCorrector -> MediaOut"

技术细节

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

许可证

MIT