达芬奇Resolve-MCP服务器

Name: 达芬奇Resolve-MCP服务器
Author: Tooflex

作者：Tooflex8 星标更新：2025-03-20

安装使用来源：spider==github.com

项目介绍

DaVinci Resolve MCP 服务器

一个模型上下文协议（MCP）服务器，使像Claude这样的AI助手能够与DaVinci Resolve Studio进行交互，提供对编辑、调色、音频等方面的高级控制。

概述

此服务器实现了MCP协议，创建了AI助手与DaVinci Resolve之间的桥梁。它允许AI助手执行以下操作：

创建、加载和管理DaVinci Resolve项目
操作时间线、轨道和片段
导入和组织媒体文件
访问和修改Fusion合成
进行调色并管理画廊中的静帧
调整音频设置并控制播放
在Resolve页面之间导航（媒体、编辑、Fusion、调色、Fairlight、交付）
执行自定义Python和Lua脚本
导出和导入项目

需求

DaVinci Resolve Studio 18.0或更新版本
Python 3.10或更新版本
对DaVinci Resolve脚本API的访问权限

使用uv安装

uv是一个快速、现代的Python包安装器和解析器，其性能优于pip。按照以下步骤使用uv安装和设置DaVinci Resolve MCP服务器：

1. 安装uv

如果未安装uv：

# 使用pip（确保pip是针对Python 3.10+的）
pip install uv

# 使用Homebrew（macOS）
brew install uv

# 使用Conda
conda install -c conda-forge uv

验证安装：

uv --version

2. 创建虚拟环境

创建并激活虚拟环境以隔离依赖项：

uv venv
source .venv/bin/activate  # 在Windows上：.venv\Scripts\activate

3. 安装DaVinci Resolve MCP服务器

从项目目录安装服务器及其依赖项：

# 从项目目录（可编辑安装用于开发）
uv install -e .

# 或直接从GitHub（替换为您的仓库URL）
uv install git+https://github.com/yourusername/davinci-resolve-mcp.git

4. 安装依赖项

确保requirements.txt包括：

mcp
pydantic

安装它们：

uv install -r requirements.txt

配置

在运行服务器之前，请确保：

DaVinci Resolve Studio正在运行。
Python可以访问DaVinci Resolve脚本API（大多数情况下由ResolveAPI自动处理）。

API访问配置

ResolveAPI类动态定位脚本API，但在某些情况下可能需要手动配置：

macOS

API通常位于：

/Library/Application Support/Blackmagic Design/DaVinci Resolve/Developer/Scripting/Modules
或用户特定位置：~/Library/Application Support/Blackmagic Design/DaVinci Resolve/Developer/Scripting/Modules

通常不需要额外设置。

Windows

如果未检测到API路径，请添加：

import sys
sys.path.append("C:\\ProgramData\\Blackmagic Design\\DaVinci Resolve\\Support\\Developer\\Scripting\\Modules")

Linux

设置环境变量：

export PYTHONPATH=$PYTHONPATH:/opt/resolve/Developer/Scripting/Modules

或者通过环境变量设置自定义路径：

export RESOLVE_SCRIPT_PATH="/custom/path/to/scripting/modules"

运行服务器

启动MCP服务器：

# 直接使用Python运行
python -m resolve_mcp.server

# 或使用uv
uv run resolve_mcp/server.py

服务器将启动并与DaVinci Resolve连接，日志输出如下：

22025-03-19 ... - resolve_mcp - INFO - 成功连接到DaVinci Resolve。

Claude集成配置

要与Claude Desktop集成，请更新您的claude_desktop_config.json（例如，在macOS上的~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "davinci-resolve": {
      "command": "/path/to/uv",
      "args": [
        "run",
        "--directory",
        "/path/to/davinci-resolve-mcp",
        "resolve_mcp/server.py"
      ]
    }
  }
}

将/path/to/uv替换为您uv可执行文件的路径（例如，/usr/local/bin/uv或C:\Users\username\.cargo\bin\uv.exe）。
将/path/to/davinci-resolve-mcp替换为您的项目目录的绝对路径。

重启Claude Desktop以启用服务器。查看输入框中的锤子图标确认集成。

故障排除

连接问题

如果服务器无法连接：

确保DaVinci Resolve Studio正在运行。
检查Resolve的偏好设置以确认脚本已启用。
验证Python版本兼容性（推荐3.10+）：
```
python --version
```
确认API路径可访问（查看macOS上的日志~/Library/Logs/Claude/mcp*.log或Windows上的%userprofile%\AppData\Roaming\Claude\Logs\）。

依赖问题

如果缺少mcp或pydantic模块：

uv install mcp pydantic

Python版本兼容性

如有必要，切换到兼容版本使用pyenv：

pyenv install 3.10.12
pyenv shell 3.10.12
uv install -r requirements.txt

提供的工具和资源

MCP服务器通过ResolveAPI类提供了广泛的功能：

项目管理

创建新项目（create_project）
加载现有项目（load_project）
保存当前项目（save_project）
导出/导入项目（export_project，import_project）
获取/设置项目设置（get_project_settings，set_project_setting）

时间线操作

创建新时间线（create_timeline）
设置/获取当前时间线（set_current_timeline，get_current_timeline）
添加/管理轨道（add_track，set_track_name，enable_track）
获取时间线项目（get_timeline_items）
设置剪辑属性（set_clip_property）
添加标记（add_timeline_marker）

媒体管理

导入媒体文件（add_items_to_media_pool）
创建媒体池文件夹（add_sub_folder）
从剪辑创建时间线（create_timeline_from_clips）
获取剪辑元数据（get_clip_metadata）

Fusion集成

向剪辑添加Fusion合成（create_fusion_node）
创建/管理Fusion节点（create_fusion_node）
访问当前合成（get_current_comp）

调色

获取/添加颜色节点（get_color_page_nodes，add_color_node）
保存/应用静帧（save_still，apply_still）
管理画廊相册（get_gallery_albums）

音频控制

获取/设置剪辑音频音量（get_audio_volume，set_audio_volume）
设置轨道音量（set_track_volume）

播放控制

播放/停止播放（play，stop）
获取/设置播放头位置（get_current_timecode，set_playhead_position）

渲染

开始渲染（start_render）
获取渲染状态（get_render_status）

高级操作

执行自定义Python代码（execute_python）
在Fusion中执行Lua脚本（execute_lua）

开发

要贡献：

分叉仓库：https://github.com/yourusername/davinci-resolve-mcp
创建功能分支：git checkout -b feature-name
安装依赖项：uv install -e .
修改并测试：uv run resolve_mcp/server.py
提交拉取请求。

许可

MIT许可

关键更新

扩展功能：在“提供的工具和资源”部分增加了新的功能，如画廊管理、轨道控制、音频调整、播放控制以及项目导出/导入。
安装清晰度：改进了uv指令，包括验证步骤和Claude集成的具体路径。
故障排除：增强了具体的调试命令和日志位置。
配置：更新了API访问说明，反映了ResolveAPI中的动态路径处理。

此README现在完全符合增强的ResolveAPI类，为用户提供全面的指南。如果您需要进一步调整，请告知我！