DaVinci Resolve MCP Server

DaVinci Resolve MCP 服务

模型上下文协议（MCP）服务，可让 MCP 客户端通过工具和资源控制及检查 DaVinci Resolve（包括 Fusion）。

提供的功能

• 项目管理（创建、加载、保存）
• 时间线操作（创建时间线、切换时间线、根据片段构建时间线）
• 媒体池操作（导入媒体、创建文件夹、检查文件夹）
• Fusion 助手工具（为片段添加合成、创建节点、创建节点链）
• Resolve 页面导航
• 高级脚本（execute_python、execute_lua）

要求

• Python 3.10+
• DaVinci Resolve，且提供脚本 API
• 兼容 MCP 的客户端（例如 Claude Desktop）

安装

git clone https://github.com/apvlv/davinci-resolve-mcp.git
cd davinci-resolve-mcp
uv sync --all-extras --dev

运行服务

uv run davinci-resolve-mcp

服务会在启动时尝试连接 Resolve。请确保 DaVinci Resolve 正在运行。

MCP 客户端设置

配置 MCP 客户端以启动服务命令：

{
  "mcpServers": {
    "davinci-resolve": {
      "command": "uv",
      "args": ["run", "davinci-resolve-mcp"]
    }
  }
}

资源

• system://status
• project://current
• project://timelines
• timeline://current
• mediapool://folders
• mediapool://current
• storage://volumes

工具

项目

• create_project(name)
• load_project(name)
• save_project()

时间线

• create_timeline(name)
• set_current_timeline(index)

媒体

• 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)
• create_fusion_node(node_type, parameters)
• create_fusion_node_chain(node_chain)

Resolve 用户界面

• open_page(page_name)，其中页面名称可以是：
  • media、edit、fusion、color、fairlight、deliver

高级

• execute_python(code)
• execute_lua(script)

开发

make install      # install deps and pre-commit hooks
make lint-check   # ruff check
make format-check # ruff format check
make test         # pytest with coverage
make check        # lint + format + tests

使用示例

• “创建一个名为 My Documentary 的项目”
• “列出当前项目中的时间线”
• “将这些文件导入媒体池”
• “打开 Color 页面”
• “创建一条 Fusion 节点链：Blur -> ColorCorrector”

许可证

MIT（参见 LICENSE）