DaVinci Resolve MCP

<p align="center"> <a href="https://github.com/casey/just"><img src="https://img.shields.io/badge/just-ready_to_go-7c5cfc?style=flat-square&logo=just&logoColor=white" alt="Just"></a> <a href="https://github.com/astral-sh/ruff"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff"></a> <a href="https://python.org"><img src="https://img.shields.io/badge/Python-3.13+-3776AB?style=flat-square&logo=python&logoColor=white" alt="Python"></a> <a href="https://github.com/PrefectHQ/fastmcp"><img src="https://img.shields.io/badge/FastMCP-3.2-7c5cfc?style=flat-square" alt="FastMCP"></a> </p>

DaVinci Resolve is Blackmagic Designs post-production suite: editing, Fusion VFX, color grading, Fairlight audio, and delivery in one timeline. Its used for everything from YouTube cuts to theatrical finishthis repo automates a running session through Resolves Python scripting API, not a separate cloud service.

---

<p align="center"> <strong>Drive DaVinci Resolve from your AI assistant</strong><br/> _{Model Context Protocol (MCP) FastMCP 3.1.0+ Blackmagic scripting API} </p>

---

Talk to Resolve in natural languageprojects, media, timelines, color, Fairlight, renderwithout leaving Claude, Cursor, or another MCP client. Tools are grouped into a small portmanteau surface so the model stays focused; sampling and agentic helpers run when your host supports them.

| | | |:--|:--| | For editors | Fewer round-trips between the NLE and a separate chat; one server, many operations. | | For automators | Same patterns as other MCP servers in the fleet: stdio, optional HTTP, optional web_sota dashboard (10842 / 10843). | | For operators | Uses Resolves official Python scripting module on the same machineno mystery bridge. |

<p align="center"> <a href="#quick-start"><strong>Quick start</strong></a> &nbsp;&nbsp; <a href="docs/INSTALL.md"><strong>Install</strong></a> &nbsp;&nbsp; <a href="docs/USAGE.md"><strong>Usage</strong></a> &nbsp;&nbsp; <a href="docs/DAVINCI_RESOLVE.md"><strong>Resolve setup</strong></a> </p>

---

Quick Start

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

This opens an interactive dashboard showing all available commands. Run just bootstrap to install dependencies, then just serve or just dev to start.

Manual Setup

If you don't have just installed:

Documentation

| | | |--|--| | docs/INSTALL.md | Install paths, web UI (10842 / 10843), Zed, MCPB | | docs/ARCHITECTURE.md | Diagram, tools, fleet standards links, repo layout | | docs/DAVINCI_RESOLVE.md | Scripting API, preferences, trademarks | | docs/USAGE.md | Clients, env, config, examples, tool overview | | docs/DEVELOPMENT.md | Tests, Ruff, builds, contributing | | docs/README.md | Index of all of the above |

Fleet 2026 conventions (ports, FastMCP 3.1.0, packaging) are defined in **mcp-central-docs**start at standards/AGENT_PROTOCOLS.md. A compact mapping table lives in docs/ARCHITECTURE.md.

---

🛡️ Industrial Quality Stack

This project adheres to SOTA 14.1 industrial standards for high-fidelity agentic orchestration:

• Python (Core): Ruff for linting and formatting. Zero-tolerance for print statements in core handlers (T201).
• Webapp (UI): Biome for sub-millisecond linting. Strict noConsoleLog enforcement.
• Protocol Compliance: Hardened stdout/stderr isolation to ensure crash-resistant JSON-RPC communication.
• Automation: Justfile recipes for all fleet operations (just lint, just fix, just dev).
• Security: Automated audits via bandit and safety.

Stack

Backend: Python 3.12, FastMCP 3.4.4+, FastAPI + Uvicorn, Pydantic v2, Typer CLI, uv deps, ruff lint, pytest tests. Webapp (web_sota/): React 19, Vite 7, TypeScript, TailwindCSS, Radix UI, TanStack Query, Zustand (LLM state), Lucide icons, React Router 7, Biome lint, Playwright e2e. Native: Tauri 2.0 (native/), NSIS installer.

Tools

9 portmanteau tools by default (RESOLVE_TOOL_MODE=portmanteau): resolve_project, resolve_media, resolve_timeline, resolve_color, resolve_render, resolve_audio, resolve_fairlight, resolve_subtitle, resolve_system (READ-ONLY) — plus help, get_status, agentic workflows, 3 prompts (edit_plan, color_recipe, render_checklist) and skill:// resources. Full catalog: docs/TOOLS.md.

Ports

Backend 10843 (/api/v1/*), frontend 10842 (Vite dev, proxies /api). Registered pair — never 3000/5000/5173/8000/8080.

Environment

| Var | Default | |-----|---------| | RESOLVE_TOOL_MODE | portmanteau | | MCP_TRANSPORT | stdio | | HOST / PORT | 127.0.0.1 / 10843 | | OLLAMA_URL | http://127.0.0.1:11434 |

See docs/CONFIGURATION.md and docs/ONBOARDING.md.

Claude Desktop config

{
  "mcpServers": {
    "davinci-resolve": {
      "command": "C:\\Users\\sandr\\.local\\bin\\uv.exe",
      "args": ["run", "davinci-resolve-mcp", "mcp"],
      "cwd": "D:\\Dev\\repos\\davinci-resolve-mcp"
    }
  }
}

License

MITsee LICENSE.

DaVinci Resolve is a trademark of Blackmagic Design. This project is not affiliated with Blackmagic.

---

Support

• Issues: github.com/sandraschi/davinci-resolve-mcp/issues
• Docs site (if published): sandraschi.github.io/davinci-resolve-mcp

GitHub Topics

da-vinci-resolve mcp-server fastmcp video-editing color-grading fairlight model-context-protocol python automation video-production post-production nle fusion-vfx blackmagic-design ai-automation mcp agentic-workflow resolve-api cli-tool beta