DaVinci Resolve控制服务器

DaVinci Resolve MCP服务器是一个允许客户端通过工具和资源控制和检查DaVinci Resolve(包括Fusion)的协议服务器。

  • by apvlv
  • Python
  • 本地部署
  • 79 星标
  • 更新于
在 GitHub 查看 apvlv/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)