AI导哈

DaVinci Resolve API服务器

DaVinci Resolve 21的MCP服务器，提供项目管理和编辑的API支持，包括时间线编辑、媒体导入、颜色分级、渲染、导出和AI分析等功能。

  • by DigitalWorkflowCompany
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 DigitalWorkflowCompany/resolve-mcp

使用说明

DaVinci Resolve 21 MCP服务器

MCP服务器为DaVinci Resolve 21提供全面的API覆盖。公开了88个工具和20个资源，用于项目管理、时间线编辑、媒体导入、颜色分级、渲染、导出、人工智能分析（转录、音频分类、Intellisearch、Slate ID、运动去模糊、语音生成）以及自动化日报创建等复合工作流程。

专为macOS打造。需要启用脚本的DaVinci Resolve Studio。

安装

先决条件

  • DaVinci Resolve Studio 21
  • Python 3.10+
  • MCP客户端（克劳德代码、克劳德桌面等）

安装

git clone https://github.com/apvlv/resolve-mcp.git
cd resolve-mcp
pip install -e .

配置MCP客户端

添加到MCP客户端配置中（例如。 ~/.claude/settings.json):

{
  "mcpServers": {
    "davinci-resolve": {
      "command": "resolve-mcp"
    }
  }
}

或者不安装：

{
  "mcpServers": {
    "davinci-resolve": {
      "command": "python3",
      "args": ["-m", "resolve_mcp"],
      "env": {
        "PYTHONPATH": "/path/to/resolve-mcp/src"
      }
    }
  }
}

资源

资源提供对当前解析状态的只读访问。

URI 描述
resolve://system/status 连接状态、版本、当前页面
resolve://project/current 项目名称、分辨率、帧率、时间线计数
resolve://project/list 当前数据库中的所有项目名称
resolve://project/settings 完整项目设置
resolve://project/timelines 所有带索引和名称的时间线
resolve://timeline/current 当前时间线详细信息（帧、曲目、TC、FPS）
resolve://timeline/tracks 带有类型、名称、启用、锁定、项目计数的跟踪列表
resolve://timeline/markers 所有时间线标记
resolve://timeline/items 跨视频轨道的所有时间线项目
resolve://mediapool/folders 带有剪辑计数的递归文件夹树
resolve://mediapool/current-folder 当前文件夹内容
resolve://mediapool/clips 当前文件夹的剪辑详细信息
resolve://mediapool/selected-clips 当前选定的剪辑
resolve://storage/volumes 已装载的媒体存储卷
resolve://gallery/albums 画廊静态相册
resolve://gallery/stills 当前专辑中的剧照
resolve://render/jobs 渲染作业列表
resolve://render/formats 可用格式和编解码器
resolve://render/presets 渲染预设
resolve://render/is-rendering 渲染状态

工具

项目（6）

create_project, load_project, save_project, close_project, set_project_setting, disable_background_tasks

导航（1）

open_page -在媒体、剪切、编辑、融合、颜色、公平、交付之间切换

时间线（13）

create_empty_timeline, create_timeline_from_clips, set_current_timeline, set_current_timeline_by_name, delete_timeline, duplicate_timeline, add_track, delete_track, set_track_name, enable_track, lock_track, append_clips_to_timeline, set_timeline_start_timecode

媒体池（4）

create_bin, set_current_folder, move_clips_to_folder, delete_clips

媒体导入（5）

import_media, import_media_to_bin, scan_directory, import_camera_roll, import_timeline_from_file

元数据（8）

get_clip_metadata, set_clip_metadata, set_clip_metadata_batch, set_clip_property, set_clip_color, add_clip_flag, extract_qc_notes_from_markers, calculate_clip_file_sizes

剪辑（2）

rename_clips （令牌模式： {CAM}, {REEL}, {REEL:N}, {N}, {N:N}, {DATE}, {TIME}, {UID}), rename_clip

标记（6）

add_timeline_marker, delete_timeline_marker, delete_timeline_markers_by_color, add_clip_marker, get_clip_markers, delete_clip_marker

颜色分级（9）

apply_drx_grade, set_cdl, apply_cdl_from_file （CCC/EDL）， set_lut, search_and_apply_lut, copy_grade, reset_grades, get_node_graph_info

音频（4）

import_audio, auto_sync_audio, add_audio_track, generate_speech （AI语音生成器：文本到语音剪辑，可选择放置在时间线上）

渲染（8）

set_render_settings, set_render_format, add_render_job, start_render, get_render_progress, wait_for_render, delete_render_jobs, load_render_preset

出口（9）

export_timeline, export_ale, export_edl, export_fcpxml, export_aaf, export_csv, export_otio, export_drt

日报（1）

create_dailies -端到端流水线：扫描相机胶卷，创建存储箱（OCF/{Cam}/{Roll}），导入媒体，构建时间线，应用DRX/CDL/LUT等级，导入和同步音频

剧照（1）

extract_stills_from_markers -从时间线标记中提取单帧剪辑，使用成绩副本创建静止时间线

融合（3）

add_fusion_comp, create_fusion_node, create_fusion_node_chain

人工智能分析（8）

解析21个AI工具。每个操作都在一个剪辑上(clip_name)，文件夹及其嵌套文件夹(folder_path)，或当前媒体池文件夹。需要Resolve Studio，在大多数情况下，还需要来自Extras下载管理器的软件包。

transcribe_audio （可选的扬声器检测）， clear_transcription, perform_audio_classification, clear_audio_classification, remove_motion_blur （AI运动去模糊→ 新剪辑）， analyze_for_intellisearch （面部ID+更快/更好模式）， reset_intellisearch_analysis, analyze_for_slate （AI Slate ID，位置标记）

执行（2）

execute_python, execute_lua -使用stdout/stderr捕获和预先填充的Resolve API对象运行任意代码

例子

"What project is open and how many timelines does it have?"
"Import all media from /Volumes/Media/A001 as a camera roll"
"Create a timeline called 'Assembly' from all clips in the current bin"
"Apply the DRX grade at /Volumes/Grades/show.drx to all timeline clips"
"Export the current timeline as ALE with CDL values"
"Set up dailies from /Volumes/OCF/A-Cam/A001 with grade /Volumes/Grades/dailies.drx"
"Render the current timeline as ProRes 422 HQ to /Volumes/Deliveries/"
"Transcribe audio for all clips in the Interviews bin with speaker detection"
"Analyze the A-Cam folder for Intellisearch and identify faces"
"Run Slate analysis on the current folder and place green markers"
"Generate speech 'Scene 12, take 3' and add it to the timeline at 01:00:05:00"

许可证

麻省理工学院

相关 MCP