# hiteshk03/davinci-resolve-mcp architecture

> Architecture diagram of the GitHub repository hiteshk03/davinci-resolve-mcp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hiteshk03/davinci-resolve-mcp
- Repository: https://github.com/hiteshk03/davinci-resolve-mcp
- Video tour (about a minute): https://gitdiagram.com/hiteshk03/davinci-resolve-mcp/video

## Overview

The product is an MCP server that lets an AI assistant control DaVinci Resolve, including on the Free edition, through a local HTTP bridge launched inside Resolve. The main workflow is assistant → MCP tools → HTTP bridge → Resolve API; local AI tools also provide transcription, voice isolation, and background removal. README capabilities are represented as domain tool areas. The source excerpts are partial, so finer-grained handler wiring is not shown.

Main entry points: [`src/resolve_mcp_bridge.py`](https://github.com/hiteshk03/davinci-resolve-mcp/blob/main/src/resolve_mcp_bridge.py) (MCP Server), [`src/CursorBridge.py`](https://github.com/hiteshk03/davinci-resolve-mcp/blob/main/src/CursorBridge.py) (HTTP Bridge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Assistant Interface"]
  node_mcp["MCP Server"]
end

subgraph group_bridge["Local Bridge"]
  node_http_bridge["HTTP Bridge<br/>[CursorBridge.py]"]
end

subgraph group_resolve["Resolve Features"]
  node_resolve_api["Resolve API"]
  node_projects["Projects &amp; Databases"]
  node_media["Media Pool"]
  node_timeline["Timeline &amp; Tracks"]
  node_clips["Clip Editing"]
  node_markers["Markers &amp; Flags"]
  node_color["Color &amp; Fusion"]
  node_render["Rendering &amp; Export"]
  node_gallery["Gallery &amp; Stills"]
  node_titles_audio["Titles &amp; Audio"]
end

subgraph group_ai["Local AI"]
  node_ai_tools["AI Tool Handlers"]
  node_whisper["Whisper Transcription"]
  node_demucs["Demucs Isolation"]
  node_rembg["Background Removal"]
end

node_assistant(("AI Assistant"))

node_assistant -->|"issues tools"| node_mcp
node_mcp -->|"sends HTTP"| node_http_bridge
node_http_bridge -->|"calls API"| node_resolve_api
node_mcp -->|"runs AI tools"| node_ai_tools
node_ai_tools -->|"requests clip data"| node_http_bridge
node_ai_tools -->|"transcribes locally"| node_whisper
node_ai_tools -->|"isolates locally"| node_demucs
node_ai_tools -->|"removes backgrounds"| node_rembg
node_mcp -->|"exposes tools"| node_projects
node_mcp -->|"exposes tools"| node_media
node_mcp -->|"exposes tools"| node_timeline
node_mcp -->|"exposes tools"| node_clips
node_mcp -->|"exposes tools"| node_markers
node_mcp -->|"exposes tools"| node_color
node_mcp -->|"exposes tools"| node_render
node_mcp -->|"exposes tools"| node_gallery
node_mcp -->|"exposes tools"| node_titles_audio
node_http_bridge -->|"handles requests"| node_projects
node_http_bridge -->|"handles requests"| node_media
node_http_bridge -->|"handles requests"| node_timeline
node_http_bridge -->|"handles requests"| node_clips
node_http_bridge -->|"handles requests"| node_markers
node_http_bridge -->|"handles requests"| node_color
node_http_bridge -->|"handles requests"| node_render
node_http_bridge -->|"handles requests"| node_gallery
node_http_bridge -->|"handles requests"| node_titles_audio

click node_mcp "https://github.com/hiteshk03/davinci-resolve-mcp/blob/main/src/resolve_mcp_bridge.py"
click node_http_bridge "https://github.com/hiteshk03/davinci-resolve-mcp/blob/main/src/CursorBridge.py"
click node_projects "https://github.com/hiteshk03/davinci-resolve-mcp/blob/main/src/resolve_mcp_bridge.py"
click node_media "https://github.com/hiteshk03/davinci-resolve-mcp/blob/main/src/resolve_mcp_bridge.py"
click node_timeline "https://github.com/hiteshk03/davinci-resolve-mcp/blob/main/src/resolve_mcp_bridge.py"
click node_clips "https://github.com/hiteshk03/davinci-resolve-mcp/blob/main/src/resolve_mcp_bridge.py"
click node_markers "https://github.com/hiteshk03/davinci-resolve-mcp/blob/main/src/resolve_mcp_bridge.py"
click node_color "https://github.com/hiteshk03/davinci-resolve-mcp/blob/main/src/resolve_mcp_bridge.py"
click node_render "https://github.com/hiteshk03/davinci-resolve-mcp/blob/main/src/resolve_mcp_bridge.py"
click node_gallery "https://github.com/hiteshk03/davinci-resolve-mcp/blob/main/src/resolve_mcp_bridge.py"
click node_titles_audio "https://github.com/hiteshk03/davinci-resolve-mcp/blob/main/src/resolve_mcp_bridge.py"
click node_ai_tools "https://github.com/hiteshk03/davinci-resolve-mcp/blob/main/src/resolve_mcp_bridge.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_mcp toneBlue
class node_http_bridge toneAmber
class node_resolve_api,node_projects,node_media,node_timeline,node_clips,node_markers,node_color,node_render,node_gallery,node_titles_audio toneMint
class node_ai_tools,node_whisper,node_demucs,node_rembg toneRose
class node_assistant toneIndigo
```

## Components

### Assistant Interface

- [MCP Server](https://github.com/hiteshk03/davinci-resolve-mcp/blob/main/src/resolve_mcp_bridge.py): `src/resolve_mcp_bridge.py`

### Local Bridge

- [HTTP Bridge](https://github.com/hiteshk03/davinci-resolve-mcp/blob/main/src/CursorBridge.py): `src/CursorBridge.py`

### Resolve Features

- **Resolve API**
- [Projects & Databases](https://github.com/hiteshk03/davinci-resolve-mcp/blob/main/src/resolve_mcp_bridge.py): `src/resolve_mcp_bridge.py`
- [Media Pool](https://github.com/hiteshk03/davinci-resolve-mcp/blob/main/src/resolve_mcp_bridge.py): `src/resolve_mcp_bridge.py`
- [Timeline & Tracks](https://github.com/hiteshk03/davinci-resolve-mcp/blob/main/src/resolve_mcp_bridge.py): `src/resolve_mcp_bridge.py`
- [Clip Editing](https://github.com/hiteshk03/davinci-resolve-mcp/blob/main/src/resolve_mcp_bridge.py): `src/resolve_mcp_bridge.py`
- [Markers & Flags](https://github.com/hiteshk03/davinci-resolve-mcp/blob/main/src/resolve_mcp_bridge.py): `src/resolve_mcp_bridge.py`
- [Color & Fusion](https://github.com/hiteshk03/davinci-resolve-mcp/blob/main/src/resolve_mcp_bridge.py): `src/resolve_mcp_bridge.py`
- [Rendering & Export](https://github.com/hiteshk03/davinci-resolve-mcp/blob/main/src/resolve_mcp_bridge.py): `src/resolve_mcp_bridge.py`
- [Gallery & Stills](https://github.com/hiteshk03/davinci-resolve-mcp/blob/main/src/resolve_mcp_bridge.py): `src/resolve_mcp_bridge.py`
- [Titles & Audio](https://github.com/hiteshk03/davinci-resolve-mcp/blob/main/src/resolve_mcp_bridge.py): `src/resolve_mcp_bridge.py`

### Local AI

- [AI Tool Handlers](https://github.com/hiteshk03/davinci-resolve-mcp/blob/main/src/resolve_mcp_bridge.py): `src/resolve_mcp_bridge.py`
- **Whisper Transcription**
- **Demucs Isolation**
- **Background Removal**

### Other components

- **AI Assistant**

## Connections

- AI Assistant → MCP Server: issues tools
- MCP Server → HTTP Bridge: sends HTTP
- HTTP Bridge → Resolve API: calls API
- MCP Server → AI Tool Handlers: runs AI tools
- AI Tool Handlers → HTTP Bridge: requests clip data
- AI Tool Handlers → Whisper Transcription: transcribes locally
- AI Tool Handlers → Demucs Isolation: isolates locally
- AI Tool Handlers → Background Removal: removes backgrounds
- MCP Server → Projects & Databases: exposes tools
- MCP Server → Media Pool: exposes tools
- MCP Server → Timeline & Tracks: exposes tools
- MCP Server → Clip Editing: exposes tools
- MCP Server → Markers & Flags: exposes tools
- MCP Server → Color & Fusion: exposes tools
- MCP Server → Rendering & Export: exposes tools
- MCP Server → Gallery & Stills: exposes tools
- MCP Server → Titles & Audio: exposes tools
- HTTP Bridge → Projects & Databases: handles requests
- HTTP Bridge → Media Pool: handles requests
- HTTP Bridge → Timeline & Tracks: handles requests
- HTTP Bridge → Clip Editing: handles requests
- HTTP Bridge → Markers & Flags: handles requests
- HTTP Bridge → Color & Fusion: handles requests
- HTTP Bridge → Rendering & Export: handles requests
- HTTP Bridge → Gallery & Stills: handles requests
- HTTP Bridge → Titles & Audio: handles requests