达芬奇Resolve-MCP服务器

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

作者：samuelgursky418 星标更新：2025-10-21

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

项目介绍

DaVinci Resolve MCP Server

一个模型上下文协议（MCP）服务器，连接AI编码助手（如Cursor、Claude Desktop）到DaVinci Resolve，使它们能够通过自然语言查询和控制DaVinci Resolve。

功能

有关已实现和计划的功能的全面列表，请参阅docs/FEATURES.md。

要求

macOS 或 Windows 并安装了DaVinci Resolve
Python 3.6+
DaVinci Resolve 在后台运行
（可选）Node.js/npm 对于某些功能

安装指南

详细的安装说明，请参阅INSTALL.md。本指南涵盖：

前提条件和系统要求
分步安装过程
配置细节
常见故障排除步骤

平台支持

平台	状态	一键安装	快速开始
macOS	✅ 稳定	`./install.sh`	`./run-now.sh`
Windows	✅ 稳定	`install.bat`	`run-now.bat`
Linux	❌ 不支持	N/A	N/A

快速开始指南

新的一键安装（推荐）

最简单的方法是使用我们的新统一安装脚本。此脚本会自动完成一切：

克隆仓库：

git clone https://github.com/samuelgursky/davinci-resolve-mcp.git
cd davinci-resolve-mcp

确保DaVinci Resolve Studio已安装并正在运行
运行安装脚本： macOS/Linux:
```
./install.sh
```
Windows:
```
install.bat
```

这将：

自动检测系统上的正确路径
创建Python虚拟环境
从官方仓库安装MCP SDK
设置环境变量
配置Cursor/Claude集成
验证安装是否正确
可选地启动MCP服务器

替代快速开始

您也可以使用原始的快速开始脚本：

Windows 用户：

run-now.bat

macOS 用户：

chmod +x run-now.sh
./run-now.sh

配置

对于与不同AI助手客户端（如Cursor或Claude）集成的DaVinci Resolve MCP配置，请参阅config-templates目录。

故障排除

详细的故障排除指导，请参阅INSTALL.md文件，其中包含常见问题的解决方案。

常见问题

路径解析

安装脚本现在使用更强大的路径解析，解决了run-now.sh在错误位置查找文件的问题
总是让脚本根据其位置确定正确的路径

DaVinci Resolve 检测

我们改进了进程检测，可靠地找到DaVinci Resolve，无论它在进程列表中如何显示
确保在启动MCP服务器之前DaV-inci Resolve正在运行

环境变量

确保所有必需的环境变量都设置正确
查看日志文件scripts/cursor_resolve_server.log进行故障排除

Windows

确保在配置文件中使用正斜杠(/)
Python必须安装，并且路径在配置中设置
在启动服务器之前确保DaVinci Resolve正在运行

macOS

确保脚本具有执行权限
使用Console.app检查任何与Python相关的错误
验证环境变量设置正确
在启动服务器之前确保DaVinci Resolve正在运行

支持

对于问题和功能请求，请使用GitHub问题跟踪器。

启动选项

安装后，您可以使用以下几种方式启动服务器：

客户端特定启动脚本

该仓库包括用于特定客户端启动的专用脚本：

# 用于Cursor集成（macOS）
chmod +x scripts/mcp_resolve-cursor_start
./scripts/mcp_resolve-cursor_start

# 用于Claude Desktop集成（macOS）
chmod +x scripts/mcp_resolve-claude_start
./scripts/mcp_resolve-claude_start

这些专用脚本：

为每个客户端设置适当的环境
验证DaVinci Resolve正在运行
配置客户端特定设置
使用适当的参数启动MCP服务器

启动前检查

在连接AI助手之前，验证您的环境是否正确配置：

# 在macOS上
./scripts/check-resolve-ready.sh

# 在Windows上
./scripts/check-resolve-ready.bat

这些脚本将：

验证DaVinci Resolve正在运行（如果未运行则提供启动选项）
检查环境变量是否正确设置
确保Python环境配置正确
验证Cursor/Claude配置
可选地启动Cursor

统一启动器

对于高级用户，我们的统一启动器提供了对Cursor和Claude Desktop服务器的完全控制：

# 将脚本设为可执行（仅限macOS）
chmod +x scripts/mcp_resolve_launcher.sh

# 在交互模式下运行
./scripts/mcp_resolve_launcher.sh

# 或使用命令行选项
./scripts/mcp_resolve_launcher.sh --start-cursor    # 启动Cursor服务器（使用mcp_resolve-cursor_start）
./scripts/mcp_resolve_launcher.sh --start-claude    # 启动Claude Desktop服务器（使用mcp_resolve-claude_start）
./scripts/m_ resolve_launcher.sh --start-both      # 启动两个服务器
./scripts/mcp_resolve_launcher.sh --stop-all        # 停止所有正在运行的服务器
./scripts/mcp_resolve_launcher.sh --status          # 显示服务器状态

其他选项：

强制模式（跳过Resolve运行检查）：--force
项目选择：--project "项目名称"

完整安装

对于完整的手动安装：

克隆此仓库：

git clone https://github.com/samuelgursky/davinci-resolve-mcp.git
cd davinci-resolve-mcp

创建Python虚拟环境：

# 创建虚拟环境
python -m venv venv

# 激活它
# 在macOS/Linux上：
source venv/bin/activate
# 在Windows上：
venv\Scripts\activate

# 从requirements.txt安装依赖项
pip install -r requirements.txt

# 或者直接安装MCP SDK
pip install git+https://github.com/modelcontextprotocol/python-sdk.git

设置DaVinci Resolve脚本环境变量：

对于macOS：

export RESOLVE_SCRIPT_API="/Library/Application Support/Blackmagic Design/DaVinci Resolve/Developer/Scripting"
export RESOLVE_SCRIPT_LIB="/Applications/DaVinci Resolve/DaVinci Resolve.app/Contents/Libraries/Fusion/fusionscript.so"
export PYTHONPATH="$PYTHONPATH:$RESOLVE_SCRIPT_API/Modules/"

对于Windows：

set RESOLVE_SCRIPT_API=C:\ProgramData\Blackmagic Design\DaVinci Resolve\Support\Developer\Scripting
set RESOLVE_SCRIPT_LIB=C:\Program Files\Blackmagic Design\DaVinci Resolve\fusionscript.dll
set PYTHONPATH=%PYTHONPATH%;%RESOLVE_SCRIPT_API%\Modules

或者运行预启动检查脚本，它会为您设置这些变量：

# 在macOS上
./scripts/check-resolve-ready.sh

# 在Windows上
./scripts/check-resolve-ready.bat

配置Cursor以使用服务器，通过创建配置文件：

对于macOS（~/.cursor/mcp.json）：

{
  "mcpServers": {
    "davinci-resolve": {
      "name": "DaVinci Resolve MCP",
      "command": "/path/to/your/venv/bin/python",
      "args": [
        "/path/to/your/davinci-resolve-mcp/src/main.py"
      ]
    }
  }
}

对于Windows（%APPDATA%\Cursor\mcp.json）：

{
  "mcpServers": {
    "davinci-resolve": {
      "name": "DaVinci Resolve MCP",
      "command": "C:\\path\\to\\venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\davinci-resolve-mcp\\src\\main.py"]
    }
  }
}

使用其中一个客户端特定脚本启动服务器：

# 对于Cursor
./scripts/mcp_resolve-cursor_start

# 对于Claude Desktop
./scripts/mcp_resolve-claude_start

与AI助手的使用

与Cursor的使用

使用专用脚本启动Cursor服务器：

./scripts/mcp_resolve-cursor_start

或使用统一启动器：

./scripts/mcp_resolve_launcher.sh --start-cursor

启动Cursor并打开一个项目。
在Cursor的AI聊天中，您可以与DaVinci Resolve互动。尝试命令如：
- “正在运行的DaVinci Resolve版本是什么？”
- “列出DaVinci Resolve中的所有项目”
- “创建一个名为'My Sequence'的新时间线”
- “在当前位置添加一个标记”

与Claude Desktop的使用

使用config-templates目录中的模板，在Claude Desktop配置目录中创建一个claude_desktop_config.json文件。

使用专用脚本启动Claude Desktop服务器：

./scripts/mcp_resolve-claude_start

或使用统一启动器：

./scripts/mcp_resolve_launcher.sh --start-claude

在Claude Desktop中，您可以使用与Cursor相同的命令与DaVinci Resolve互动。

可用功能

通用

获取DaVinci Resolve版本
获取/切换当前页面（编辑、颜色、融合等）

项目管理

列出可用项目
获取当前项目名称
按名称打开项目
创建新项目
保存当前项目

时间线操作

列出所有时间线
获取当前时间线信息
创建新时间线
按名称切换时间线
在时间线上添加标记

媒体池操作

列出媒体池剪辑
导入媒体文件
创建媒体箱
将剪辑添加到时间线

Windows 支持注意事项

Windows支持在v1.3.3中稳定，通常不需要额外的故障排除：

确保DaVinci Resolve安装在默认位置
如上所述正确设置环境变量
根据您的安装情况可能需要调整Windows路径
对于问题，请检查logs/目录中的日志

故障排除

DaVinci Resolve 连接

确保在启动服务器之前DaVinci Resolve正在运行。如果服务器无法连接到Resolve，请检查：

您的环境变量是否设置正确
您是否有正确的DaVinci Resolve安装路径
在设置环境变量后是否重新启动了终端

项目结构

davinci-resolve-mcp/
├── README.md               # 此文件
├── docs/                   # 文档
│   ├── FEATURES.md         # 功能列表和状态
│   ├── CHANGELOG.md        # 版本历史
│   ├── VERSION.md          # 版本信息
│   ├── TOOLS_README.md     # 工具文档
│   ├── PROJECT_MCP_SETUP.md # 项目设置指南
│   └── COMMIT_MESSAGE.txt  # 最新提交信息
├── config-templates/       # 配置模板
│   ├── sample_config.json  # 示例配置
│   ├── cursor-mcp-example.json # Cursor配置示例
│   └── mcp-project-template.json # MCP项目模板
├── scripts/                # 实用脚本
│   ├── tests/              # 测试脚本
│   │   ├── benchmark_server.py # 性能测试
│   │   ├── test_improvements.py # 测试脚本
│   │   ├── test_custom_timeline.py # 时间线测试
│   │   ├── create_test_timeline.py # 创建测试时间线
│   │   ├── test-after-restart.sh # 重启后测试（Unix）
│   │   └── test-after-restart.bat # 重启后测试（Windows）
│   ├── batch_automation.py # 批处理自动化脚本
│   ├── restart-server.sh   # 服务器重启脚本（Unix）
│   ├── restart-server.bat  # 服务器重启脚本（Windows）
│   ├── run-now.sh          # 快速开始脚本（Unix）
│   └── run-now.bat         # 快速开始脚本（Windows）
├── resolve_mcp_server.py   # 主服务器实现
├── src/                    # 源代码
│   ├── api/                # API实现
│   ├── features/           # 功能模块
│   └── utils/              # 实用函数
├── logs/                   # 日志文件
├── tools/                  # 开发工具
├── assets/                 # 项目资源
└── examples/               # 示例代码

许可证

MIT

致谢

Blackmagic Design 提供DaVinci Resolve及其API
MCP协议团队使AI助手集成成为可能

作者

Samuel Gursky (samgursky@gmail.com)

GitHub: github.com/samuelgursky

未来计划

Windows 和 Linux 支持
更多DaVinci Resolve功能
支持Claude Desktop

开发

如果您想贡献，请查看存储库中的功能清单并选择一个未实现的功能来工作。代码结构清晰，分为不同的功能区域。

许可证

MIT

致谢

Blackmagic Design 提供DaVinci Resolve及其API
MCP协议团队使AI助手集成成为可能

项目结构

清理后，项目的结构如下：

resolve_mcp_server.py - 主MCP服务器实现
run-now.sh - 快速开始脚本，处理设置并运行服务器
setup.sh - 完整设置脚本用于安装
check-resolve-ready.sh - 启动前检查，验证DaVinci Resolve是否准备好
start-server.sh - 启动服务器的脚本
run-server.sh - 简化的直接运行服务器的脚本

关键目录：

src/ - 源代码和模块
assets/ - 项目资源和资源
logs/ - 日志文件目录
scripts/ - 辅助脚本

开发时，建议使用./run-now.sh，它会在一步中设置环境并启动服务器。

更新日志

详见docs/CHANGELOG.md获取详细的更改历史。

Cursor特定设置

当与Cursor集成时，请遵循以下特定步骤：

确保在启动Cursor之前DaVinci Resolve正在运行
安装所需依赖项：
```
# 从davinci-resolve-mcp目录：
pip install -r requirements.txt
```
注意：这将自动安装MCP包和其他依赖项。
在Cursor中设置MCP服务器配置：

创建或编辑~/.cursor/mcp.json（macOS）（或%USERPROFILE%\.cursor\mcp.json（Windows））：
```
{
  "mcpServers": {
    "davinci-resolve": {
      "name": "DaVinci Resolve MCP",
      "command": "/path/to/your/venv/bin/python",
      "args": [
        "/path/to/your/davinci-resolve-mcp/src/main.py"
      ]
    }
  }
}
```
重要提示：
- 使用main.py作为入口点（而不是resolve_mcp_server.py）
- 在配置中使用绝对路径
常见问题：
- “客户端关闭”错误：检查mcp.json中的路径是否正确以及依赖项是否已安装
- 连接问题：确保在启动Cursor之前DaVinci Resolve正在运行
- 环境变量：main.py脚本会处理设置环境变量