Управление DaVinci Resolve Studio от клиентов MCP, таких как Claude Desktop.

Этот проект раскрывает проекты Resolve, временные рамки, медиа, Fusion, цвет, аудио, воспроизведение и рендеринг операций через локальный Сервер протокола Model Context.

Что он делает

Сервер предоставляет:

32 инструмента MCP для редактирования и управления Resolve; 6 ресурсов MCP, описывающих текущее состояние Resolve;

• автоматическое открытие скриптового API DaVinci Resolve на Windows, macOS, и Linux;
• защищенный нативный модульный зонд, поэтому нарушенный fusionscript импорт не сбой MCP-сервера; Изоляция времени выполнения Windows для предотвращения загрузки несовместимого Resolve Python DLL.

Примеры запросов от клиента MCP:

Создание проекта под названием «Запуск продукта».

Импортируйте эти три клипа и создайте временную шкалу под названием «Rough Cut».

Добавить синий маркер в кадр 240 с примечанием «Переход обзора».

Сохраните текущий класс как все еще в альбоме «Approved Looks».

Требования

DaVinci Resolve Studio 18 или новее Внешний скрипт должен быть включен. 64-битный CPython 3.10 или 3.11. Скриптовый модуль Resolve все еще импортируется T1, который был удален из Python 3.12.

DaVinci Resolve MCP Server

Control DaVinci Resolve Studio from MCP clients such as Claude Desktop.

This project exposes Resolve projects, timelines, media, Fusion, color, audio, playback, and rendering operations through a local Model Context Protocol server.

What it does

The server provides:

• 32 MCP tools for editing and controlling Resolve;
• 6 read-only MCP resources describing the current Resolve state;
• automatic discovery of the DaVinci Resolve scripting API on Windows, macOS, and Linux;
• a protected native-module probe, so a broken fusionscript import does not crash the MCP server;
• Windows runtime isolation to prevent Resolve from loading an incompatible Python DLL.

Example requests from an MCP client:

Create a project called “Product Launch”.

Import these three clips and create a timeline called “Rough Cut”.

Add a blue marker at frame 240 with the note “Review transition”.

Save the current grade as a still in the “Approved Looks” album.

Requirements

• DaVinci Resolve Studio 18 or newer. External scripting must be enabled.
• 64-bit CPython 3.10 or 3.11. Resolve’s scripting module still imports imp, which was removed from Python 3.12.
• The DaVinci Resolve scripting API installed with Resolve.
• An MCP client such as Claude Desktop.

Before starting the server, open Resolve and set:

Preferences → System → General → External scripting using → Local

The free edition of Resolve does not expose the external scripting connection used by this server. The MCP process can start, but it will remain disconnected.

Installation

Clone the repository first:

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

Windows

Use a regular 64-bit Python from python.org. Do not use a uv-managed standalone Python on Windows: Resolve’s fusionscript.dll is known to crash with those builds.

Install Python 3.10:

winget install --id Python.Python.3.10 -e

Create the environment and install the dependencies:

& "$env:LOCALAPPDATA\Programs\Python\Python310\python.exe" -m venv .venv310
.\.venv310\Scripts\python.exe -m pip install --upgrade pip
.\.venv310\Scripts\python.exe -m pip install -e .

Start the server through the Windows launcher:

.\run_server.ps1

Always use run_server.ps1 on Windows. It pins Resolve to the correct Python runtime, isolates PATH, and configures the scripting API paths before starting the server.

macOS

Create a virtual environment with CPython 3.10 or 3.11:

python3.11 -m venv .venv
./.venv/bin/python -m pip install --upgrade pip
./.venv/bin/python -m pip install -e .

Start the server:

./.venv/bin/davinci-resolve-mcp

The standard Resolve API locations are detected automatically:

• /Library/Application Support/Blackmagic Design/DaVinci Resolve/Developer/Scripting/Modules