DaVinci Resolve MCP Server

基本能力

产品定位

DaVinci Resolve MCP Server 是一个桥梁，连接 AI 助手与 DaVinci Resolve Studio，提供对视频编辑、调色、音频处理等功能的自动化控制。

核心功能

• 项目管理：创建、加载、保存、导出/导入项目。
• 时间线操作：创建时间线、管理轨道、设置剪辑属性、添加标记。
• 媒体管理：导入媒体文件、创建媒体池文件夹、获取剪辑元数据。
• Fusion 集成：添加 Fusion 合成、管理 Fusion 节点。
• 调色：管理调色节点、保存/应用静帧、管理画廊相册。
• 音频控制：调整剪辑和轨道音量。
• 播放控制：控制播放、设置播放头位置。
• 渲染：启动渲染、获取渲染状态。
• 导航：切换 DaVinci Resolve 的不同页面（媒体、编辑、Fusion、调色、Fairlight、交付）。
• 高级操作：执行自定义 Python 和 Lua 脚本。

适用场景

• 自动化视频编辑：通过 AI 助手自动化完成视频编辑任务。
• 批量处理：批量导入媒体、创建时间线、调整音频和调色。
• 远程控制：通过 AI 助手远程控制 DaVinci Resolve 的功能。
• 教育与培训：用于教学或培训场景，展示 DaVinci Resolve 的功能。

工具列表

• ResolveAPI 类：提供与 DaVinci Resolve 交互的核心功能。
• uv：快速、现代的 Python 包安装工具，用于安装和管理依赖。
• Claude 集成：通过配置文件将服务器与 Claude 桌面应用集成。

常见问题解答

• 连接问题：确保 DaVinci Resolve Studio 正在运行，且脚本功能已启用。
• 依赖问题：使用 uv install 安装缺失的依赖。
• Python 版本兼容性：推荐使用 Python 3.10 或更高版本。

使用教程

使用依赖

1. 安装 Python 3.10 或更高版本。
2. 安装 DaVinci Resolve Studio 18.0 或更高版本。

安装教程

1. 安装 uv： bash pip install uv
2. 创建虚拟环境： bash uv venv source .venv/bin/activate
3. 安装服务器： bash uv install -e .
4. 安装依赖： bash uv install -r requirements.txt

调试方式

1. 启动服务器： bash python -m resolve_mcp.server
2. 检查日志文件（如 ~/Library/Logs/Claude/mcp*.log）以排查问题。
3. 确保 DaVinci Resolve 的脚本 API 路径已正确配置。

许可证

该项目遵循 MIT 开源许可条款。