Skip to main content
Glama
Airta-Admin

io.github.Airta-Admin/davinc-resolve-local-bridge-mcp

by Airta-Admin

Davinc-Resolve-Local-Bridge-MCP


Что это?

Davinc-Resolve-Local-Bridge-MCP — это сервер Model Context Protocol (MCP), который даёт ИИ-ассистентам полный контроль над DaVinci Resolve. Он предоставляет 215 инструментов, покрывающих весь API скриптинга Resolve — проекты, таймлайны, медиа, Fusion, цветокоррекцию, рендеринг и многое другое.

Как это работает

Your AI Assistant (Claude, Cursor, Devin, etc.)
       │
       │  talks MCP (stdio)
       ▼
  mcp_server/server.py        ← runs on your machine
       │
       │  talks HTTP (localhost:8787)
       ▼
  Bridge-Connection-Script.py ← runs INSIDE DaVinci Resolve
       │                        (Workspace > Scripts menu)
       ▼
  DaVinci Resolve API         ← full read + write access

Скрипт моста запускается внутри процесса DaVinci Resolve, что даёт ему полный доступ к API скриптинга Resolve — даже в бесплатной версии (которая блокирует внешний скриптинг). MCP-сервер работает как отдельный процесс и проксирует вызовы инструментов к мосту через HTTP на localhost.


Related MCP server: resolve-mcp

Быстрый старт

Предварительные требования

  • DaVinci Resolve 18.5+ (Free или Studio)

  • Python 3.10+ на вашем компьютере

  • MCP-совместимый ИИ-ассистент (Claude Desktop, Cursor, Devin и т.д.)

Шаг 1 — Установите скрипт моста

Запустите установщик:

python install.py

Или вручную скопируйте bridge/Bridge-Connection-Script.py в папку скриптов Resolve:

Платформа

Путь

Windows

%APPDATA%\Roaming\Blackmagic Design\DaVinci Resolve\Support\Fusion\Scripts\Utility\

macOS

~/Library/Application Support/Blackmagic Design/DaVinci Resolve/Fusion/Scripts/Utility/

Linux

~/.local/share/DaVinciResolve/Fusion/Scripts/Utility/

Шаг 2 — Установите зависимости MCP-сервера

pip install -r requirements.txt

Шаг 3 — Настройте вашего ИИ-ассистента

Добавьте MCP-сервер в файл конфигурации вашего ассистента. Путь к серверу — mcp_server/server.py в этом репозитории.

Claude Desktop

Отредактируйте claude_desktop_config.json:

{
  "mcpServers": {
    "davinci-resolve-local-bridge": {
      "command": "python",
      "args": ["C:/path/to/Davinc-Resolve-Local-Bridge-MCP/mcp_server/server.py"]
    }
  }
}

Cursor

Отредактируйте .cursor/mcp.json:

{
  "mcpServers": {
    "davinci-resolve-local-bridge": {
      "command": "python",
      "args": ["C:/path/to/Davinc-Resolve-Local-Bridge-MCP/mcp_server/server.py"]
    }
  }
}

Devin

Отредактируйте mcp_config.json:

{
  "mcpServers": {
    "resolve-local-bridge": {
      "command": "python",
      "args": ["C:/path/to/Davinc-Resolve-Local-Bridge-MCP/mcp_server/server.py"]
    }
  }
}

Claude Code

claude mcp add davinci-resolve-local-bridge -- python C:/path/to/Davinc-Resolve-Local-Bridge-MCP/mcp_server/server.py

Любой MCP-клиент (универсальный)

Сервер использует stdio-транспорт. Запустите его с помощью:

python mcp_server/server.py

Шаг 4 — Запустите мост внутри DaVinci Resolve

  1. Откройте DaVinci Resolve

  2. Перейдите в Workspace → Scripts → Bridge-Connection-Script

  3. Посмотрите в Console (Workspace → Console) на:

[Resolve Bridge] Connected to Resolve 21.0.4.5
[Resolve Bridge] HTTP server running on http://127.0.0.1:8787
[Resolve Bridge] 215 actions available

Шаг 5 — Начните использовать

Спросите вашего ИИ-ассистента:

"Проверь, подключен ли DaVinci Resolve"

Ассистент вызовет инструмент resolve_status и сообщит результат. Затем попробуйте:

"Создай новый проект 1920x1080 30fps под названием 'My Video' и добавь таймлайн"


Архитектура

Скрипт моста (bridge/Bridge-Connection-Script.py)

Python-скрипт, который запускается внутри DaVinci Resolve через меню Workspace > Scripts. Он:

  • Получает живой объект resolve из глобальных переменных Fusion

  • Запускает HTTP-сервер на 127.0.0.1:8787

  • Предоставляет 3 конечные точки:

    • GET /health — проверка, жив ли мост

    • GET /actions — список всех доступных имён действий

    • POST /action — выполнение действия по имени с параметрами

  • Остаётся активным с помощью блокирующего вызова serve_forever()

  • Убивает любой предыдущий экземпляр на том же порту перед запуском

MCP-сервер (mcp_server/server.py)

Автономный MCP-сервер, который:

  • Подключается к мосту по HTTP на localhost

  • Автоматически обнаруживает все 215 действий из конечной точки /actions моста

  • Предоставляет каждое действие как MCP-инструмент с префиксом resolve_

  • Проксирует вызовы инструментов к мосту через POST /action

  • Остаётся синхронизированным с мостом — ручные определения инструментов не нужны


Все 215 инструментов

MCP-сервер автоматически обнаруживает инструменты из моста. Каждый инструмент имеет префикс resolve_ (например, status становится resolve_status). Передавайте параметры как объект params.

Приложение Resolve (15 инструментов)

Инструмент

Параметры

Описание

resolve_status

Проверить подключение к мосту и получить информацию о текущем проекте/таймлайне

resolve_get_version

Получить информацию о версии Resolve

resolve_get_current_page

Получить активную страницу (edit, cut, color и т.д.)

resolve_open_page

page

Переключиться на страницу: edit, cut, fusion, color, fairlight, deliver, media

resolve_get_layout_presets

Список доступных пресетов раскладки

resolve_load_layout_preset

presetName

Загрузить пресет раскладки по имени

resolve_get_keyframe_mode

Получить текущий режим ключевых кадров

resolve_set_keyframe_mode

keyframeMode

Установить режим ключевых кадров

resolve_get_fairlight_presets

Список аудиопресетов Fairlight

resolve_get_burnin_presets

Список пресетов burn-in

resolve_import_render_preset

presetPath

Импортировать пресет рендеринга из файла

resolve_export_render_preset

presetName, exportPath

Экспортировать пресет рендеринга в файл

resolve_open_fusion_page

Переключиться на страницу Fusion

resolve_open_edit_page

Переключиться на страницу Edit

resolve_open_deliver_page

Переключиться на страницу Deliver

Менеджер проектов (18 инструментов)

Инструмент

Параметры

Описание

resolve_create_project

name, width, height, fps

Создать новый проект

resolve_load_project

name

Загрузить существующий проект

resolve_save_project

Сохранить текущий проект

resolve_close_project

Закрыть текущий проект

resolve_delete_project

name

Удалить проект

resolve_create_folder

folderName

Создать папку проекта

resolve_delete_folder

folderName

Удалить папку проекта

resolve_get_project_list

Список проектов в текущей папке

resolve_get_folder_list

Список подпапок в текущей папке

resolve_get_current_folder

Получить имя текущей папки

resolve_open_folder

folderName

Открыть папку

resolve_goto_root_folder

Перейти в корневую папку

resolve_goto_parent_folder

Перейти в родительскую папку

resolve_import_project

filePath, projectName

Импортировать проект .drp

resolve_export_project

projectName, filePath, withStillsAndLUTs

Экспортировать проект как .drp

resolve_archive_project

projectName, filePath, ...

Архивировать проект

resolve_get_current_database

Получить имя текущей базы данных

resolve_get_database_list

Список доступных баз данных

Настройки проекта (7 инструментов)

Инструмент

Параметры

Описание

resolve_get_project_name

Получить имя текущего проекта

resolve_set_project_name

name

Переименовать текущий проект

resolve_get_project_setting

key

Получить настройку проекта по ключу

resolve_set_project_setting

key, value

Установить настройку проекта

resolve_get_project_settings

Получить все настройки проекта

resolve_get_project_preset_list

Список пресетов проекта

resolve_set_project_preset

presetName

Применить пресет проекта

Медиа-хранилище (4 инструмента)

Инструмент

Параметры

Описание

resolve_get_mounted_volumes

Список подключенных томов хранилища

resolve_get_subfolder_list

folderPath

Список подпапок в пути

resolve_get_file_list

folderPath

Список файлов в папке

resolve_reveal_in_storage

path

Показать файл в файловом браузере ОС

Медиапул (13 инструментов)

Инструмент

Параметры

Описание

resolve_import_media

paths (list)

Импортировать медиафайлы в пул

resolve_get_media_pool

Список всех клипов в корневой папке

resolve_get_root_folder

Получить информацию о корневой папке

resolve_add_sub_folder

folderName, parentFolderName

Создать подпапку

resolve_set_current_folder

folderName

Установить текущую папку

resolve_delete_clips

clipNames (list)

Удалить клипы из пула

resolve_move_clips

clipNames, targetFolder

Переместить клипы в папку

resolve_relink_clips

clipNames, folderPath

Переподключить клипы

resolve_unlink_clips

clipNames

Отключить клипы

resolve_export_metadata

fileName, clipNames

Экспортировать метаданные CSV

resolve_get_selected_clips

Список выбранных клипов

resolve_set_selected_clip

clipName

Выбрать клип

resolve_add_timeline_mattes

paths (list)

Добавить файлы матов

Таймлайн (21 инструмент)

Tool

Parameters

Description

resolve_create_timeline

name

Создать новую пустую временную шкалу

resolve_create_timeline_from_clips

name, clipNames

Создать временную шкалу из клипов

resolve_list_timelines

Перечислить все временные шкалы

resolve_get_timeline_name

Получить имя текущей временной шкалы

resolve_set_timeline_name

name

Переименовать текущую временную шкалу

resolve_set_current_timeline

timelineIndex

Переключиться на временную шкалу по индексу (начиная с 1)

resolve_duplicate_timeline

Дублировать текущую временную шкалу

resolve_delete_timelines

timelineNames

Удалить временные шкалы

resolve_get_timeline_start_frame

Получить начальный кадр

resolve_get_timeline_end_frame

Получить конечный кадр

resolve_get_start_timecode

Получить начальный таймкод

resolve_set_start_timecode

timecode

Установить начальный таймкод

resolve_get_current_timecode

Получить текущий таймкод

resolve_set_current_timecode

timecode

Установить текущий таймкод

resolve_detect_scene_cuts

Обнаружить склейки сцен

resolve_create_subtitles_from_audio

settings

Автоматически создать субтитры

resolve_timeline_export

fileName, exportType, exportSubtype

Экспортировать временную шкалу

resolve_import_timeline_from_file

filePath

Импортировать временную шкалу из файла

resolve_append_to_timeline

clipNames

Добавить клипы во временную шкалу

resolve_get_timeline_setting

key

Получить настройку временной шкалы

resolve_set_timeline_setting

key, value

Установить настройку временной шкалы

Дорожки временной шкалы (11 инструментов)

Tool

Parameters

Description

resolve_get_track_count

trackType

Подсчитать дорожки (видео/аудио/субтитры)

resolve_add_track

trackType

Добавить дорожку

resolve_delete_track

trackType, trackIndex

Удалить дорожку

resolve_set_track_enable

trackType, trackIndex, enabled

Включить/отключить дорожку

resolve_get_track_enable

trackType, trackIndex

Проверить, включена ли дорожка

resolve_set_track_lock

trackType, trackIndex, locked

Заблокировать/разблокировать дорожку

resolve_get_track_lock

trackType, trackIndex

Проверить, заблокирована ли дорожка

resolve_get_track_name

trackType, trackIndex

Получить имя дорожки

resolve_set_track_name

trackType, trackIndex, name

Установить имя дорожки

resolve_get_items_in_track

trackType, index

Перечислить клипы на дорожке

resolve_get_timeline_selected_clips

Перечислить выбранные клипы временной шкалы

Элементы временной шкалы (66 инструментов)

Все действия с элементами принимают необязательные параметры trackType, trackIndex, itemIndex для выбора конкретного клипа или работают с первым выбранным клипом, если они не указаны.

Инструмент

Параметры

Описание

resolve_get_item_name

trackType?, trackIndex?, itemIndex?

Получить имя клипа

resolve_set_item_name

name, trackType?, ...

Переименовать клип

resolve_get_item_duration

trackType?, ...

Получить длительность клипа

resolve_get_item_start

trackType?, ...

Получить начальный кадр клипа

resolve_get_item_end

trackType?, ...

Получить конечный кадр клипа

resolve_get_item_property

key?, trackType?, ...

Получить свойство клипа

resolve_set_item_property

key, value, trackType?, ...

Установить свойство клипа

resolve_get_item_enabled

trackType?, ...

Проверить, включен ли клип

resolve_set_item_enabled

enabled, trackType?, ...

Включить/отключить клип

resolve_set_item_color

colorName, trackType?, ...

Установить цвет клипа

resolve_get_item_color

trackType?, ...

Получить цвет клипа

resolve_clear_item_color

trackType?, ...

Очистить цвет клипа

resolve_add_item_flag

color, trackType?, ...

Добавить флаг

resolve_get_item_flags

trackType?, ...

Получить флаги

resolve_clear_item_flags

color, trackType?, ...

Очистить флаги

resolve_add_item_marker

frameId, color, name, note?, ...

Добавить маркер

resolve_get_item_markers

trackType?, ...

Получить маркеры

resolve_insert_generator

generatorName

Вставить генератор

resolve_insert_fusion_generator

generatorName

Вставить генератор Fusion

resolve_insert_fusion_composition

Вставить композицию Fusion

resolve_insert_ofx_generator

generatorName

Вставить генератор OFX

resolve_insert_title

titleName

Вставить заголовок

resolve_insert_fusion_title

titleName

Вставить заголовок Fusion

resolve_grab_still

Захватить стоп-кадр из текущего кадра

resolve_grab_all_stills

Захватить стоп-кадры из всех клипов

resolve_create_compound_clip

name

Создать составной клип

resolve_create_fusion_clip

Создать клип Fusion

resolve_import_into_timeline

filePath, importOptions?

Импортировать в таймлайн

resolve_stabilize

trackType?, ...

Стабилизировать клип

resolve_smart_reframe

trackType?, ...

Умное перекадрирование клипа

resolve_create_magic_mask

mode, trackType?, ...

Создать Magic Mask

resolve_regenerate_magic_mask

trackType?, ...

Пересоздать Magic Mask

resolve_get_item_track_info

trackType?, ...

Получить информацию о дорожке для клипа

resolve_get_linked_items

trackType?, ...

Получить связанные элементы

resolve_set_item_cdl

cdl, trackType?, ...

Установить значения CDL

resolve_add_take

mediaPoolItemName, startFrame?, endFrame?

Добавить дубль

resolve_get_takes_count

trackType?, ...

Подсчитать дубли

resolve_select_take_by_index

idx, trackType?, ...

Выбрать дубль

resolve_finalize_take

trackType?, ...

Завершить текущий дубль

resolve_copy_grades

targetItemNames, trackType?, ...

Скопировать грейды на другие клипы

resolve_export_lut

exportType, path, trackType?, ...

Экспортировать LUT

resolve_set_color_output_cache

cache_value, trackType?, ...

Установить кэш цветового вывода

resolve_set_fusion_output_cache

cache_value, trackType?, ...

Установить кэш вывода Fusion

resolve_get_clip_metadata

metadataType?

Получить метаданные клипа

resolve_set_clip_metadata

metadataType, metadataValue

Установить метаданные клипа

resolve_get_clip_property

propertyName?

Получить свойство клипа

resolve_set_clip_property

propertyName, propertyValue

Установить свойство клипа

resolve_link_proxy_media

proxyMediaFilePath

Связать прокси-медиа

resolve_unlink_proxy_media

Отвязать прокси-медиа

resolve_replace_clip

filePath

Заменить клип файлом

resolve_add_clip_marker

frameId, color, name, note?

Добавить маркер клипа

resolve_get_clip_markers

Получить маркеры клипа

resolve_set_clip_color

colorName

Установить цвет клипа (медиапул)

resolve_add_clip_flag

color

Добавить флаг клипа

resolve_transcribe_clip_audio

useSpeakerDetection?

Транскрибировать аудио

resolve_set_clip_mark_inout

markIn, markOut, type

Установить точки входа/выхода

resolve_clear_clip_mark_inout

type

Очистить точки входа/выхода

resolve_add_timeline_marker

frameId, color, name, note?

Добавить маркер таймлайна

resolve_get_timeline_markers

Получить маркеры таймлайна

resolve_delete_timeline_markers_by_color

color

Удалить маркеры по цвету

resolve_delete_timeline_marker_at_frame

frameNum

Удалить маркер в кадре

resolve_export_current_frame

filePath

Экспортировать текущий кадр как стоп-кадр

resolve_apply_fairlight_preset

name

Применить пресет Fairlight

resolve_get_quick_export_presets

Список пресетов быстрого экспорта

Композиции Fusion (14 инструментов)

Инструмент

Параметры

Описание

resolve_create_fusion_comp

name

Создать композицию Fusion

resolve_add_fusion_comp

trackType?, ...

Добавить композицию Fusion к клипу

resolve_import_fusion_comp

path, trackType?, ...

Импортировать файл .comp

resolve_export_fusion_comp

path, compIndex?, trackType?, ...

Экспортировать композицию Fusion

resolve_load_fusion_comp_by_name

compName, trackType?, ...

Загрузить композицию по имени

resolve_delete_fusion_comp_by_name

compName, trackType?, ...

Удалить композицию по имени

resolve_rename_fusion_comp

oldName, newName, trackType?, ...

Переименовать композицию

resolve_get_item_fusion_comp_count

trackType?, ...

Подсчитать композиции Fusion на клипе

resolve_get_item_fusion_comp_names

trackType?, ...

Список имен композиций Fusion

resolve_get_current_comp

Получить текущую композицию Fusion

resolve_fusion_get_comp_list

Список всех открытых композиций

resolve_fusion_new_comp

Создать новую композицию Fusion

resolve_fusion_save_comp

filePath

Сохранить текущую композицию

resolve_fusion_load_comp

filePath

Загрузить файл композиции

resolve_fusion_close_comp

Закрыть текущую композицию

resolve_fusion_render_comp

Рендерить текущую композицию

Инструменты Fusion (11 инструментов)

Инструмент

Параметры

Описание

resolve_fusion_get_tool_list

Список всех инструментов/узлов в текущей композиции

resolve_fusion_find_tool

name

Найти инструмент по имени

resolve_fusion_delete_tool

name

Удалить инструмент

resolve_fusion_get_attrs

name

Получить атрибуты инструмента

resolve_fusion_set_attrs

name, attrs

Установить атрибуты инструмента

resolve_fusion_add_node

nodeType, name

Добавить узел (Background, Paint, Merge и т.д.)

resolve_fusion_connect

fromNode, toNode, input

Соединить два узла

resolve_fusion_set_input

node, input, value, frame?

Установить вход узла (можно с ключевыми кадрами)

resolve_fusion_get_input

node, input

Получить значение входа узла

resolve_fusion_set_current_frame

frame

Установить текущий кадр

resolve_fusion_get_current_frame

Получить текущий кадр

Галерея (4 инструмента)

Инструмент

Параметры

Описание

resolve_get_gallery_still_albums

Список альбомов стоп-кадров галереи

resolve_get_gallery_powergrade_albums

Список альбомов PowerGrade

resolve_create_gallery_still_album

Создать альбом стоп-кадров

resolve_create_powergrade_album

Создать альбом PowerGrade

Цвет / Узлы (7 инструментов)

Инструмент

Параметры

Описание

resolve_get_node_count

Получить количество узлов на текущем клипе

resolve_get_node_label

nodeIndex

Получить метку узла

resolve_get_node_lut

nodeIndex

Получить LUT узла

resolve_set_node_lut

nodeIndex, lutPath

Установить LUT на узел

resolve_set_node_enabled

nodeIndex, isEnabled

Включить/отключить узел

resolve_reset_all_grades

Сбросить все грейды

resolve_refresh_lut_list

Обновить список LUT

Рендеринг (22 инструмента)

Инструмент

Параметры

Описание

resolve_get_render_formats

Список форматов рендеринга

resolve_get_render_codecs

renderFormat

Список кодеков для формата

resolve_get_current_render_format_codec

Получить текущий формат/кодек

resolve_set_render_format_codec

format, codec

Установить формат и кодек рендеринга

resolve_get_render_mode

Получить режим рендеринга

resolve_set_render_mode

renderMode

Установить режим рендеринга

resolve_get_render_resolutions

format, codec

Список разрешений рендеринга

resolve_get_render_preset_list

Список пресетов рендеринга

resolve_load_render_preset

presetName

Загрузить пресет рендеринга

resolve_save_as_new_render_preset

presetName

Сохранить новый пресет рендеринга

resolve_delete_render_preset

presetName

Удалить пресет рендеринга

resolve_set_render_settings

settings

Установить настройки рендеринга (TargetDir, CustomName и т.д.)

resolve_add_render_job

Добавить задачу рендеринга

resolve_delete_render_job

jobId

Удалить задачу рендеринга

resolve_delete_all_render_jobs

Удалить все задачи рендеринга

resolve_get_render_job_list

Список задач рендеринга

resolve_start_rendering

jobIds?, isInteractiveMode?

Начать рендеринг

resolve_stop_rendering

Остановить рендеринг

resolve_is_rendering_in_progress

Проверить, выполняется ли рендеринг

resolve_get_render_status

jobId

Получить статус задачи рендеринга

resolve_render_with_quick_export

presetName

Быстрый экспорт

resolve_render

settings?

Добавить задачу и начать рендеринг

Речь и субтитры (1 инструмент)

Инструмент

Параметры

Описание

resolve_generate_speech

text, voice?

Сгенерировать аудио речи с помощью ИИ

Специальные (1 инструмент)

Инструмент

Параметры

Описание

resolve_create_hand_animation

imagePath, ...

Создать анимацию рисования от руки (техника Daniel Batal)


Устранение неполадок

Мост не запускается

  • Убедитесь, что DaVinci Resolve запущен и открыт проект

  • Проверьте консоль (Workspace → Console) на наличие сообщений об ошибках

  • Перезапустите DaVinci Resolve — он сканирует папку Scripts только при запуске

«Не удалось подключиться к Resolve Bridge»

  • Убедитесь, что вы запустили Workspace → Scripts → Bridge-Connection-Script внутри Resolve

  • Проверьте, что в консоли отображается [Resolve Bridge] HTTP server running on http://127.0.0.1:8787

  • Если порт уже занят, закройте Resolve и откройте его снова (устаревшие процессы fuscript.exe могут удерживать порт)

Инструменты возвращают ошибки

  • Сначала вызовите resolve_status, чтобы проверить подключение

  • Некоторые действия требуют открытого проекта, наличия таймлайна или выбранного клипа

  • Сообщения об ошибках от моста указывают, чего не хватает


Технические детали

  • Порт моста: 127.0.0.1:8787 (только localhost, без внешнего доступа)

  • Транспорт: HTTP/1.0 с Connection: close

  • Транспорт MCP: stdio

  • Зависимости: mcp, requests (только для MCP-сервера; мост использует чистую стандартную библиотеку)

  • Версия Resolve: 18.5+ (протестировано на 21.0.4.5)

  • Python: 3.10+ для MCP-сервера; мост использует встроенный Python Resolve


Лицензия

Лицензия MIT — см. файл LICENSE.


Авторы

Создано The Geek Gods. Вдохновлено сообществом скриптинга DaVinci Resolve.

A
license - permissive license
Not graded
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • OCR, transcription, file extraction, and image generation for AI agents via MCP.

  • A real timeline video editor for AI agents: journaled edits, FFmpeg/MLT rendering, exports

  • MCP server for Clipkit — gives AI agents a video toolbox via the Clipkit schema.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Airta-Admin/Davinc-Resolve-Local-Bridge-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server