DaVinci Resolve MCP

samuelgursky/davinci-resolve-mcp· Проверено 12.11.2026· 4,1 тыс.на GitHub

Даёт агенту управлять DaVinci Resolve через Scripting API: проекты, медиапул, таймлайны, маркеры, цветокоррекция, Fusion, Fairlight и рендер. Рабочий режим — DaVinci Resolve Studio.

По умолчанию 37 сгруппированных инструментов; режим --full даёт 390, по одному на метод API.

Как подключить

Что сделать до подключения

1

DaVinci Resolve 18.5 или новее, лучше Studio; Python 3.10–3.12

2

Установить сервер: npx davinci-resolve-mcp setup или git clone репозитория и python install.py — установщик создаст venv, найдёт пути Resolve и сам пропишет клиенты

3

В DaVinci Resolve Studio включить Preferences → General → External scripting using: Local

4

Для бесплатной версии 21.0.x: python scripts/install_resolve_bridge.py, перезапустить Resolve и запустить Workspace → Scripts → resolve_bridge

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'RESOLVE_SCRIPT_API=<путь к DaVinci Resolve>/Developer/Scripting' --env 'RESOLVE_SCRIPT_LIB=<путь к fusionscript.so или fusionscript.dll>' --env 'PYTHONPATH=<путь к DaVinci Resolve>/Developer/Scripting/Modules' --transport stdio davinci-resolve \
  -- '<папка установки>/venv/bin/python' '<папка установки>/src/server.py'

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Инструменты сервера

resolve_controlподключается к Resolve и переключает страницы
project_managerсоздаёт и открывает проекты
project_settingsменяет настройки проекта
media_storageпросматривает диски и импортирует файлы
media_poolуправляет медиапулом
media_pool_itemчитает и пишет метаданные клипа
media_analysisанализирует клипы и ищет хлопушки
timelineсобирает таймлайн, дорожки и экспорт
timeline_markersставит маркеры на таймлайне
timeline_frameснимает кадр таймлайна картинкой
timeline_itemменяет трансформ, скорость и звук клипа
timeline_item_colorгрейдит клип на странице Color
graphработает с нодами цветокоррекции
gallery_stillsсохраняет стопкадры в галерею
fusion_compстроит композицию Fusion
renderнастраивает и запускает рендер
knowledgeвыдаёт советы по монтажу и цвету

Показано 17 из 37.

Что попросить агента

«Покажи все проекты и открой тот, что называется <Мой фильм>»Получит список и откроет проект через project_manager
«Собери таймлайн <Сборка> из всех клипов текущей корзины»Возьмёт клипы из медиапула через media_pool и соберёт таймлайн через timeline
«Найди хлопушки или 2-pop и предложи сдвиги для синхронизации»Проанализирует клипы через media_analysis и выдаст смещения
«Подготовь рендер в ProRes 422 HQ, проверь настройки и поставь задание в очередь»Настроит и запустит рендер через render
«Добавь поверх выбранного клипа титр Fusion TextPlus»Построит композицию через fusion_comp и проверит связи нод

Для каких задач

Собрать таймлайн Assembly Cut из всех клипов текущей корзины
Найти на таймлайне дыры, наложения и пропавшие медиафайлы
Найти двойной бип и хлопушку и предложить сдвиги для синхронизации
Сохранить грейд клипа, проверить CDL и выгрузить временный LUT
Добавить на клип текстовый оверлей Fusion TextPlus
Собрать план рендера в ProRes 422 HQ, проверить настройки и поставить задачу в очередь

Ограничения

!

Внешний скриптинг Blackmagic открыла только в Studio: бесплатная версия подключается лишь через мост внутри Resolve, и только до 21.0.x — в 21.1 Python-скрипты бесплатной версии убрали

!

Мост для бесплатной версии Blackmagic может закрыть в любой момент

!

Сервер не выбирает удачный дубль, не оценивает монтаж и не собирает готовый музыкальный монтаж: он выдаёт первую сборку, которую дорабатываете вы

!

Исходники сервер не меняет и не перекодирует без прямой просьбы; разрушительные действия идут через план, проверку и подтверждение

Если не работает

Сервер не подключается к бесплатной версии Resolve
Внешние скрипты работают только в Studio. Для бесплатной версии 21.0.x поставьте мост командой python scripts/install_resolve_bridge.py, перезапустите Resolve, откройте проект и запустите Workspace > Scripts > resolve_bridge. В 21.1 Python-скрипты доступны только в Studio.
Studio не отвечает серверу
Поставьте Preferences > General > External scripting using в Local и проверьте Python командой python3 scripts/doctor.py: она покажет проблему и строку Fix с командой.
На macOS скрипт resolve_bridge не появляется в меню Scripts
Resolve ищет Python в PYTHON3HOME и /usr/local/bin/python3: выполните launchctl setenv PYTHON3HOME "$(python3 -c 'import sys; print(sys.prefix)')" и перезапустите Resolve.
Через несколько недель скрипты пропали из меню без ошибок
launchctl setenv сбрасывается после перезагрузки: для постоянной настройки сделайте ссылку sudo ln -s "$(command -v python3)" /usr/local/bin/python3.
Мост на Windows перестал отвечать (сборки до v2.70.3)
Проверьте, не держит ли порт оставшийся процесс fuscript.exe.

Частые вопросы

Нужна ли DaVinci Resolve Studio?
Для нормальной работы да: Blackmagic разрешает внешний скриптинг только в Studio. Бесплатная версия 21.0.x подключается через мост resolve_bridge внутри программы, а в 21.1 Python-скрипты в бесплатной версии убрали.
Где лежат пути для RESOLVE_SCRIPT_API и RESOLVE_SCRIPT_LIB?
На macOS: /Library/Application Support/Blackmagic Design/DaVinci Resolve/Developer/Scripting и fusionscript.so внутри DaVinci Resolve.app. На Windows: C:\ProgramData\Blackmagic Design\DaVinci Resolve\Support\Developer\Scripting и fusionscript.dll в папке Resolve. На Linux: /opt/resolve/Developer/Scripting и /opt/resolve/libs/Fusion/fusionscript.so.
Чем режим 37 инструментов отличается от 390?
Режим по умолчанию группирует операции за параметром action и экономит контекст. Режим --full даёт по инструменту на каждый метод Resolve API, он для опытных пользователей.
Сервер может испортить исходники?
Нет: камерные оригиналы он считает неизменяемыми. Отчёты анализа пишутся в отдельные папки, а метаданные — только в базу проекта Resolve.
На бесплатной версии в macOS скрипт моста не появляется в меню. Почему?
Resolve ищет Python 3 только в PYTHON3HOME и /usr/local/bin/python3. Укажите свой Python командой launchctl setenv PYTHON3HOME и перезапустите Resolve; после перезагрузки компьютера настройку нужно повторить.
Работает ли сервер из России?
Сервер работает на вашем компьютере рядом с Resolve и не открывает сетевой порт; ключи и зарубежные аккаунты не нужны.

Похожие серверы