DaVinci Resolve控制工具

解决mcp问题

DaVinci Resolve最全面的MCP服务器。 295+个工具，涵盖完整的DaVinci Resolve脚本API（v20.3）-从Claude、ChatGPT或任何MCP-兼容AI助手控制Resolve的各个方面。

什么是resolve mcp？

resolve-mcp 是一个 模型上下文协议（MCP） 暴露的服务器 295+工具 用于通过Claude、Claude Code、Cursor、Windsurf、ChatGPT和任何其他MCP客户端等AI助手控制DaVinci Resolve。

它将自然语言转化为Resolve脚本API调用，让您通过与人工智能的对话来管理项目、编辑时间表、分级颜色、渲染可交付成果、管理媒体池、控制Fusion合成等等。

为什么要解决mcp？

• 全面覆盖API -295多种工具，涵盖每个Resolve脚本API表面：项目、媒体池、时间线、编辑、标记、渲染、颜色分级、Fusion、Fairlight、画廊、节点图、杜比视觉和立体3D
• 需要零代码 --只需与您的AI助手交谈： “以24fps创建一个名为“Final Cut”的新时间线” 或 “为每个切割点添加溶解过渡”
• 单线安装 — uvx resolve-mcp 或 pip install resolve-mcp
• 适用于任何MCP客户端 --Claude Desktop、Claude Code、Cursor、Windsurf、VS Code+Continue或您自己的MCP客户端
• 可选的AI编辑工具 --3个额外的Gemini驱动工具，用于AI时间线分析、标记驱动编辑和自动标记放置
• 跨平台 --macOS、Windows、Linux（无论Resolve在哪里运行）

快速开始

先决条件

1. 达芬奇调色 （免费或工作室）必须正在运行
2. 启用脚本： Preferences → System → General → External scripting using = Network
3. Python 3.11+
4. FFmpeg （仅适用于AI工具）： brew install ffmpeg （macOS）或 apt install ffmpeg （Linux）

安装

# Using uvx (recommended — runs in isolated environment)
uvx resolve-mcp

# Using pip
pip install resolve-mcp

# Using pipx
pipx install resolve-mcp

# Install with the AI editing assistant (resolve-assistant) included
pip install resolve-mcp[assistant]

配置Claude桌面

添加到您的Claude Desktop MCP配置中：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json
• Linux： ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "resolve-mcp": {
      "command": "uvx",
      "args": ["resolve-mcp"]
    }
  }
}

配置Claude代码

添加到您的项目 .mcp.json:

{
  "mcpServers": {
    "resolve-mcp": {
      "command": "uvx",
      "args": ["resolve-mcp"]
    }
  }
}

配置光标/风帆/VS代码

按照编辑器的MCP服务器配置文档，指向 uvx resolve-mcp 作为命令。

启用AI桥接工具（可选）

使用3个Gemini驱动的AI工具(resolve_analyze_timeline, resolve_add_markers, resolve_build_from_markers)，设置您的Gemini API密钥：

{
  "mcpServers": {
    "resolve-mcp": {
      "command": "uvx",
      "args": ["resolve-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key-here"
      }
    }
  }
}

Windows注意事项： 如果 uvx 不在系统PATH中，请使用完整路径 uvx.exe （例如。， C:\\Users\\YOU\\.local\\bin\\uvx.exe)作为 "command" 价值。

在获取免费Gemini API密钥 aistudio.google.com.

同时使用两台服务器——resolve mcp+resolve assistant

resolve-mcp 给你 295多种直接控制DaVinci Resolve的工具 --项目、时间线、编辑、颜色分级、渲染、Fusion、Fairlight等。

解决助理 是一个单独的MCP服务器，它添加 人工智能驱动的自动编辑 --将其指向一个镜头文件夹并给出编辑指令，它使用Google Gemini自动观看每一帧、计划编辑并在Resolve中构建时间线。

它们是独立的MCP服务器。 您可以单独使用其中一个，也可以将两者结合使用，以获得完整的AI视频编辑工具包。当一起使用时，您可以完全手动控制Resolve（Resolve mcp）以及AI驱动的镜头分析和自动时间线构建（Resolve助手）。

用一个命令安装两者

# Install resolve-mcp with the AI editing assistant included
pip install resolve-mcp[assistant]

# Or install them separately
pip install resolve-mcp
pip install resolve-assistant

配置两台服务器

因为他们是 两个独立的MCP服务器，每个都需要在Claude Desktop或Claude Code配置中有自己的条目。以下是两台服务器的完整配置：

克劳德桌面版 (~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上， %APPDATA%\Claude\claude_desktop_config.json 在Windows上， ~/.config/Claude/claude_desktop_config.json 在Linux上）：

{
  "mcpServers": {
    "resolve-mcp": {
      "command": "uvx",
      "args": ["resolve-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key-here"
      }
    },
    "resolve-assistant": {
      "command": "uvx",
      "args": ["resolve-assistant"],
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key-here"
      }
    }
  }
}

克劳德代码 (.mcp.json 在项目根目录中）：

{
  "mcpServers": {
    "resolve-mcp": {
      "command": "uvx",
      "args": ["resolve-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key-here"
      }
    },
    "resolve-assistant": {
      "command": "uvx",
      "args": ["resolve-assistant"],
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key-here"
      }
    }
  }
}

注： GEMINI_API_KEY 对于解析mcp是可选的（只有3个AI桥接工具需要它），但 必需的 解决助理。两个服务器使用相同的Gemini API密钥。

我需要哪台服务器？

有关AI编辑助手的更多信息，请参阅 解析辅助文档.

工具类别

项目管理（10个工具）

创建、打开、关闭、保存和配置DaVinci Resolve项目。切换数据库、管理项目设置和查询项目元数据。

媒体池（21个工具）

导入、组织、搜索和管理媒体池中的剪辑。创建存储箱、移动剪辑、设置元数据、重新链接媒体等。

时间线管理（15个工具）

创建、复制、删除、导入和导出时间线。管理轨迹、设置时间线属性以及在时间线之间导航。

编辑（12个工具）

操纵时间线项目——设置属性、变换、合成模式、速度更改和剪辑级别操作。

标记和游戏头（9个工具）

在时间线上添加、编辑、删除和查询标记。控制播放头位置。

渲染（14个工具）

配置渲染设置、管理渲染队列和控制渲染作业。

颜色分级（12个工具）

控制颜色分级——应用LUT、设置CDL值、管理节点、复制分级、抓取静止图像和导出帧。

Fusion（8个工具）

管理时间线剪辑上的Fusion合成。

Fairlight Audio（4个工具）

控制Fairlight音频功能——语音隔离、音频插入和曲目信息。

其他类别

• 剪辑元数据 （18个工具）——标记、标志、代理管理、转录
• 时间线项目 （11个工具）——项目级标记和标志
• 剪辑版本 （11个工具）——版本管理、颜色组分配
• 画廊和剧照 （7个工具）--静止相册，静止导出/导入
• 节点图 （5个工具）——节点标签、启用/禁用、工具检查
• 布局预设 （22个工具）——UI布局、渲染预设、老化预设
• 杜比视觉和立体3D （4个工具）——杜比视觉分析、立体转换
• 媒体存储 （3个工具）--浏览卷和存储位置
• 项目经理 （10个工具）--归档、删除、导入、还原项目
• 仓位/文件夹操作 （4个工具）--转录、元数据导出、文件夹ID
• 生成器和标题 （13个工具）——插入生成器、标题、融合构图、场景剪切检测

AI桥接工具（3个工具，需要GEMINI_API_KEY）

MCP资源（只读）

使用示例

配置后，只需自然地与您的AI助手交谈：

项目管理

“列出我的所有Resolve项目” “以4K 24fps创建一个名为“夏季活动”的新项目” “当前的项目设置是什么？”

媒体池

“将/Volumes/Media/Footage中的所有文件导入“原始”文件夹” “B-Roll箱子里有多少个剪辑？” “将“访谈”中所有剪辑的剪辑颜色设置为蓝色”

时间剪辑

“创建一个名为“Final Cut v3”的新时间线，其中包含2个视频和4个音轨” “列出视频轨道1上的所有剪辑” “在第1200帧添加一个蓝色标记，并注明‘反应良好’”

渲染

“为H.265 MP4设置4K渲染作业” “开始渲染并告诉我何时完成” “有哪些可用的渲染预设？”

颜色分级

“将'Kodak 2383'LUT应用于当前剪辑” “设置CDL提升，为阴影增添温暖” “从当前帧中抓取静止图像”

AI驱动的分析（需要Gemini）

“分析当前的时间表并给我编辑反馈” “使用/Volumes/Media/footage中的镜头从标记中构建时间线”

Claude代码插件——技能、代理和钩子

此回购也是 Claude代码插件 它将13个以编辑器为中心的技能、3个专门的代理和安全挂钩直接安装到Claude Code中。

用一个命令安装所有内容

claude plugin add github.com/jenkinsm13/resolve-mcp

这将安装 MCP服务器 （295多种工具）一步完成所有技能、代理和钩子。不需要单独的MCP配置——插件将所有配置捆绑在一起。

注： 设定你的 GEMINI_API_KEY 如果您需要AI桥接工具，请在安装后在MCP服务器配置中。215+Resolve工具可以在没有它的情况下工作。

技能（调用 /skill-name)

代理

钩子

• .env 保护 --阻止编辑 .env 包含API密钥的文件
• 破坏性操作警告 --在“解析”中执行删除操作（剪辑、时间线、成绩、标记、箱、项目）之前发出警告

注： 该插件捆绑了MCP服务器和所有技能/代理/钩子。对于独立MCP服务器安装（无需技能），请使用 uvx resolve-mcp 或 pip install resolve-mcp.

建筑

resolve-mcp
├── resolve_mcp/               # Python package (installed via pip/uvx)
│   ├── __init__.py            # Package init, registers all tool modules
│   ├── __main__.py            # python -m resolve_mcp entry point
│   ├── config.py              # FastMCP server + optional Gemini client
│   ├── resolve.py             # DaVinci Resolve scripting API connection
│   ├── errors.py              # Error handling + @safe_resolve_call decorator
│   ├── resources.py           # MCP resources (resolve://project, etc.)
│   ├── project_tools.py       # Project management (10 tools)
│   ├── media_pool_tools.py    # Media pool operations (11 tools)
│   ├── timeline_mgmt_tools.py # Timeline management (15 tools)
│   ├── edit_tools.py          # Timeline item editing (12 tools)
│   ├── marker_tools.py        # Markers & playhead (9 tools)
│   ├── render_tools.py        # Render pipeline (14 tools)
│   ├── color_tools.py         # Color grading (12 tools)
│   ├── fusion_tools.py        # Fusion comp management (8 tools)
│   ├── fairlight_tools.py     # Fairlight audio (4 tools)
│   ├── ...                    # 10+ more tool modules
│   └── resolve_ai_tools.py    # AI bridge tools (3 tools)
├── skills/                    # Claude Code plugin skills
│   ├── color-assist/SKILL.md
│   ├── deliver/SKILL.md
│   ├── preflight/SKILL.md
│   └── ...                    # 13 skills total
├── agents/                    # Claude Code plugin agents
│   ├── color-analyst.md
│   ├── timeline-auditor.md
│   └── color-consistency-checker.md
├── hooks/hooks.json           # Claude Code plugin hooks
├── .claude-plugin/plugin.json # Plugin manifest
├── pyproject.toml
├── .env.example
└── README.md

运作原理

1. 解决mcp问题 启动注册295+个工具的FastMCP服务器
2. 您的AI客户端（Claude、Cursor等）通过MCP协议连接
3. 当您提出请求时，AI会选择适当的工具
4. 每个工具都通过Python SDK调用DaVinci Resolve脚本API
5. 结果以结构化文本的形式返回给AI进行解释

服务器通过网络脚本接口连接到Resolve，该接口必须在Resolve的首选项中启用。不需要任何插件或扩展-只需启用脚本API并运行服务器。

故障排除

“DaVinci Resolve未运行”

• 确保Resolve已打开
• 启用脚本： Preferences → System → General → External scripting using = Network
• 启用脚本后重新启动Resolve

“Resolve中没有打开的项目”

• 在使用项目相关工具之前，请在Resolve中打开或创建项目

工具未出现在Claude Desktop中

• 修改后重新启动Claude Desktop claude_desktop_config.json
• 在Claude Desktop的开发人员控制台中检查MCP服务器日志
• 验证 uvx resolve-mcp 从终端成功运行

AI桥接工具返回“未设置GEMINI_API_KEY”

• 添加 GEMINI_API_KEY 到 env MCP配置的一部分
• 215+Resolve工具可以在没有Gemini的情况下工作——只有3个AI桥接工具需要它

DaVinci Resolve API兼容性

• 测试方法： DaVinci Resolve 20.3（免费和工作室）
• 平台支持： macOS（苹果硅+英特尔）、Windows、Linux
• 仅工作室功能 明确标记——服务器优雅地处理免费版限制

相关项目

• 解决助理 --AI驱动的视频编辑助手，使用Google Gemini在DaVinci Resolve中自动分析镜头、计划专业编辑和构建时间线。与resolve mcp一起安装 pip install resolve-mcp[assistant] 完整的AI视频编辑工具包。
• FastMCP --为该服务器提供动力的MCP框架
• 模型上下文协议 --AI工具使用的开放协议

许可证

MIT许可证。看 许可证 了解详情。

贡献

欢迎投稿！请在上打开问题或PR GitHub.

专为希望使用AI控制DaVinci Resolve的视频编辑、调色师和后期制作专业人员而设计。适用于Claude Desktop、Claude Code、Cursor、Windsurf、ChatGPT和任何兼容MCP的客户端。配对 解决助理 用于AI驱动的自动编辑。