Resolve MCP Server

DaVinci Resolve MCP服务器

谈谈你的时间表。 通过Claude用自然语言控制DaVinci Resolve——浏览项目、交换剪辑、颜色等级、在YouTube上渲染，并用AI视觉查看任何帧中的内容。从你的办公桌或手机，在世界任何地方。

You:    "Replace the b-roll at 13:22 with the South Pole takeoff shot"
Claude: Done. Replaced AOA_CLIP_04 with A663C012_SOUTH_POLE_TAKE_OFF on V2.
        Same position, same duration, video only — your interview audio is untouched.

______________________________________________________________________

这是什么

一 MCP服务器 它将Claude连接到正在运行的DaVinci Resolve实例。 53工具 通过11个类别，Claude可以完全读/写您的项目、时间线、媒体池、彩色页面和渲染队列，以及通过以下方式进行AI驱动的帧分析 月亮梦.

这不是玩具。它编辑。它替换了多轨道纪录片时间线上的一个片段，匹配了持续时间，保留了音频，并将结果导出到YouTube。整个谈话。

你能做什么

通过对话进行编辑

"Open the tutorial project"
"Switch to the Full Documentary timeline"
"What clips are on V2?"
"Replace clip 2 on V2 with the milky way shot"
"Zoom in to 120% on the interview clip"
"Add a blue marker here that says 'Great take'"
"Export this for YouTube"

用人工智能的眼光看透你的时间线

"What's in this frame?"
→ A wide shot of a beach in St. Maarten with an airplane on final approach,
  turquoise water, and spectators watching from behind a chain-link fence.

"Is there a person at the podium?"
→ Yes, there is a person standing at the podium on the left side of the frame.

"How many people are visible?"
→ 4

通过手机控制解析

服务器通过Cloudflare隧道在HTTP上运行，因此您可以从沙发、汽车或其他大陆进行编辑。同样的工具，同样的功能——只需通过手机与克劳德通话。

______________________________________________________________________

53工具

______________________________________________________________________

快速开始

先决条件

• 达芬奇调色工作室 （付费-脚本API在免费版本的Resolve中不可用）
• Python 3.10+ （用3.14测试）
• A. 月亮梦API密钥 （免费层可用——用于AI视觉功能）。注册地址： 安慰.月亮梦.ai 拿到你的钥匙。每个API调用都要收费，但免费层对于正常编辑使用是慷慨的。

1.克隆并安装

git clone https://github.com/guycochran/resolve-mcp-server.git
cd resolve-mcp-server
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

2.配置API密钥

cp .env.example .env
# Edit .env and add your Moondream API key

3.添加到克劳德桌面

添加到您的Claude Desktop MCP配置(~/.claude/claude_desktop_config.json):

{
  "mcpServers": {
    "resolve": {
      "command": "/path/to/resolve-mcp-server/start.sh"
    }
  }
}

4.打开Resolve并开始交谈

“我在做什么项目？”

就是这样。克劳德现在可以在Resolve中看到并控制一切。

______________________________________________________________________

远程访问（HTTP模式）

随时随地控制Resolve——你的手机、平板电脑、另一台电脑。

# Start the server in HTTP mode
TRANSPORT=http PORT=3001 .venv/bin/python3 src/server.py

通过Cloudflare隧道（全球访问）

# Add to your cloudflared config:
#   hostname: resolve.yourdomain.com
#     service: http://localhost:3001

cloudflared tunnel run

现在将任何MCP客户端指向 https://resolve.yourdomain.com/mcp 你正在远程编辑。

______________________________________________________________________

夹子更换是如何工作的

Resolve脚本API没有覆盖编辑或三点编辑。我们建了一个。

resolve_replace_clip 执行两步操作：

1. 阅读 旧剪辑的确切时间线位置和持续时间
2. 删除 旧夹子（没有波纹——保留了间隙）
3. 插入 在相同记录位置的新剪辑具有匹配的持续时间

# What happens under the hood:
timeline.DeleteClips([old_clip], False)
pool.AppendToTimeline([{
    "mediaPoolItem": new_item,
    "trackIndex": 2,
    "recordFrame": 86734,       # exact same position
    "startFrame": 0,
    "endFrame": 120,            # matches original duration
    "mediaType": 1              # video only — preserves audio
}])

这意味着克劳德可以交换b-roll，尝试交替拍摄，并在对话中恢复。

______________________________________________________________________

AI视觉如何工作

服务器使用 月亮梦 用于AI驱动的帧分析的视觉语言模型（VLMs）。它从Resolve获取当前帧，通过Pillow（6MB PNG至~250KB JPEG）对其进行压缩，并将其发送到Moonvdream云API。

注册地址： 安慰.月亮梦.ai （可用的免费层）以获取您的API密钥。

三个工具：

• resolve_describe_frame --“这张照片里有什么？”
• resolve_detect_in_frame --查找带有边界框的对象
• resolve_ask_about_frame --关于框架的视觉问答

用例：自动场景记录、可访问性描述、内容验证、镜头匹配。

______________________________________________________________________

建筑

Phone/Tablet ──── HTTPS ────→ Cloudflare Tunnel ────→ localhost:3001
                                                           │
Claude Desktop ── stdio ──────────────────────────────────→│
                                                           │
                                                   Resolve MCP Server
                                                   (Python + FastMCP)
                                                           │
                                              ┌────────────┼────────────┐
                                              ▼            ▼            ▼
                                        DaVinci       Moondream      Cloudflare
                                        Resolve       Vision API      Tunnel
                                        (local)       (cloud)        (cloud)

项目结构

src/
├── server.py                    # FastMCP entry point (stdio + HTTP)
├── services/
│   ├── resolve_connection.py    # Resolve API connection management
│   └── moondream.py             # Moondream vision API client + image prep
└── tools/
    ├── connection.py            # Status, page navigation
    ├── project.py               # Project management
    ├── timeline.py              # Timeline operations
    ├── media.py                 # Media pool management
    ├── editing.py               # Transform, delete, replace clips
    ├── color.py                 # LUTs, color versions, grade export
    ├── markers.py               # Timeline markers
    ├── titles.py                # Fusion titles
    ├── render.py                # Rendering & export
    ├── fusion.py                # Fusion compositions
    └── vision.py                # AI frame analysis

需求

• 达芬奇调色工作室 -脚本API需要付费Studio版本
• mcp[cli] --模型上下文协议SDK
• httpx -Moonddream API的HTTP客户端
• Pillow --图像压缩（PNG→ JPEG用于视觉管道）

许可证

麻省理工学院