DaVinci Resolve MCP

DaVinci Resolve MCP服务器

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

它提供了什么

• 项目管理（创建、加载、保存）
• 时间线操作（创建时间线、切换时间线、从剪辑构建）
• 媒体池操作（导入媒体、创建文件夹、检查文件夹）
• 融合助手（将comp添加到剪辑、创建节点、创建节点链）
• 解决页面导航问题
• 高级脚本(execute_python, execute_lua)

需求

• Python 3.10+
• 提供带有脚本API的DaVinci Resolve
• 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)

融合

• 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)

解析UI

• 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"
• “列出当前项目中的时间表”
• “将这些文件导入媒体池”
• “打开颜色页面”
• “创建融合节点链模糊->颜色校正器”

许可证

麻省理工学院（见 LICENSE)