DaVinci Resolve MCP 服务器

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

功能

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

要求

• 安装了DaVinci Resolve的macOS或Windows
• 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
  

这将：

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

替代快速开始

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

Windows用户：

run-now.bat

macOS用户：

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

配置

关于如何配置DaVinci Resolve MCP以与不同的AI助手客户端（如Cursor或Claude）配合使用，请参阅 config-templates 目录。

故障排除

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

常见问题

路径解析

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

DaVinci Resolve 检测

• 我们改进了进程检测，以确保无论在进程列表中如何显示都能可靠地找到 DaVinci Resolve
• 确保在启动 MCP 服务器之前 DaVinci Resolve 已经运行

环境变量

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

Windows

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

macOS

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

支持

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

启动选项

安装后，您有多种方式启动服务器：

客户端特定启动脚本

仓库中包含针对特定客户端的专用启动脚本：

# For Cursor integration (macOS)
chmod +x scripts/mcp_resolve-cursor_start
./scripts/mcp_resolve-cursor_start

# For Claude Desktop integration (macOS)
chmod +x scripts/mcp_resolve-claude_start
./scripts/mcp_resolve-claude_start

这些专门的脚本：

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

预启动检查

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

# On macOS
./scripts/check-resolve-ready.sh

# On Windows
./scripts/check-resolve-ready.bat

这些脚本将：

• 验证 DaVinci Resolve 是否正在运行（并提供启动它的选项）
• 检查环境变量是否已正确设置
• 确保 Python 环境已正确配置
• 验证 Cursor/Claude 配置
• 可选地启动 Cursor

通用启动器

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

# Make the script executable (macOS only)
chmod +x scripts/mcp_resolve_launcher.sh

# Run in interactive mode
./scripts/mcp_resolve_launcher.sh

# Or use command line options
./scripts/mcp_resolve_launcher.sh --start-cursor    # Start Cursor server (uses mcp_resolve-cursor_start)
./scripts/mcp_resolve_launcher.sh --start-claude    # Start Claude Desktop server (uses mcp_resolve-claude_start)
./scripts/mcp_resolve_launcher.sh --start-both      # Start both servers
./scripts/mcp_resolve_launcher.sh --stop-all        # Stop all running servers
./scripts/mcp_resolve_launcher.sh --status          # Show server status

附加选项：

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

完整安装

对于完整的手动安装：

1. 克隆此仓库：

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

2. 创建 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
   

3. 设置 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
   

4. 通过创建配置文件来配置 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"]
       }
     }
   }
   

5. 使用特定客户端的脚本来启动服务器：

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

与 AI 助手一起使用

与 Cursor 一起使用

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

   ./scripts/mcp_resolve-cursor_start
   

   或者使用通用启动器：

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

2. 启动 Cursor 并打开一个项目。

3. 在 Cursor 的 AI 聊天中，你现在可以与 DaVinci Resolve 进行交互。尝试以下命令：

   • "正在运行的 DaVinci Resolve 版本是什么？"
   • "列出 DaVinci Resolve 中的所有项目"
   • "创建一个新的名为 'My Sequence' 的时间线"
   • "在当前位置添加标记"

与 Claude Desktop 一起使用

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

2. 使用专用脚本运行 Claude Desktop 服务器：

   ./scripts/mcp_resolve-claude_start
   

   或者使用通用启动器：

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

3. 现在，在 Claude Desktop 中，你可以使用与 Cursor 相同的命令与 DaVinci Resolve 进行交互。

可用功能

通用

• 获取 DaVinci Resolve 版本
• 获取/切换当前页面（编辑、调色、Fusion 等）

项目管理

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

时间线操作

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

媒体池操作

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

Windows 支持说明

v1.3.3 版本中的 Windows 支持是稳定的，不需要额外的故障排除：

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

故障排除

DaVinci Resolve 连接

确保在启动服务器之前 DaVinci Resolve 已经运行。如果服务器无法连接到 Resolve，请检查以下几点：

1. 你的环境变量设置正确
2. 你有正确的 DaVinci Resolve 安装路径
3. 设置环境变量后重启了终端

项目结构

davinci-resolve-mcp/
├── README.md               # This file
├── docs/                   # Documentation
│   ├── FEATURES.md         # Feature list and status
│   ├── CHANGELOG.md        # Version history
│   ├── VERSION.md          # Version information
│   ├── TOOLS_README.md     # Tools documentation
│   ├── PROJECT_MCP_SETUP.md # Project setup guide
│   └── COMMIT_MESSAGE.txt  # Latest commit information
├── config-templates/       # Configuration templates
│   ├── sample_config.json  # Example configuration
│   ├── cursor-mcp-example.json # Cursor config example
│   └── mcp-project-template.json # MCP project template
├── scripts/                # Utility scripts
│   ├── tests/              # Test scripts
│   │   ├── benchmark_server.py # Performance tests
│   │   ├── test_improvements.py # Test scripts
│   │   ├── test_custom_timeline.py # Timeline tests
│   │   ├── create_test_timeline.py # Create test timeline
│   │   ├── test-after-restart.sh # Test after restart (Unix)
│   │   └── test-after-restart.bat # Test after restart (Windows)
│   ├── batch_automation.py # Batch automation script
│   ├── restart-server.sh   # Server restart script (Unix)
│   ├── restart-server.bat  # Server restart script (Windows)
│   ├── run-now.sh          # Quick start script (Unix)
│   └── run-now.bat         # Quick start script (Windows)
├── resolve_mcp_server.py   # Main server implementation
├── src/                    # Source code
│   ├── api/                # API implementation
│   ├── features/           # Feature modules
│   └── utils/              # Utility functions
├── logs/                   # Log files
├── tools/                  # Development tools
├── assets/                 # Project assets
└── examples/               # Example code

许可证

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 集成时，请遵循以下特定步骤：

1. 确保在启动 Cursor 之前 DaVinci Resolve 已经运行。

2. 安装所需的依赖项：

   # 在 davinci-resolve-mcp 目录中执行：
   pip install -r requirements.txt
   

   注意：这将自动安装 MCP 包和其他依赖项。

3. 在 Cursor 中设置 MCP 服务器配置：

   在 macOS 上创建或编辑 ~/.cursor/mcp.json（或在 Windows 上编辑 %USERPROFILE%\.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"
         ]
       }
     }
   }
   

   重要提示：

   • 使用 main.py 作为入口点（而不是 resolve_mcp_server.py）
   • 在配置中使用绝对路径

4. 常见问题：

   • "Client closed" 错误：检查 mcp.json 中的路径是否正确，并确保已安装依赖项
   • 连接问题：确保在启动 Cursor 之前 DaVinci Resolve 已经运行
   • 环境变量：main.py 脚本会处理设置环境变量