de en es ja ko ru zh

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

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

by Airta-Admin

Overview Schema Source Related Servers Discussions Admin

Python

Local

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: davinci-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

Откройте DaVinci Resolve
Перейдите в Workspace → Scripts → Bridge-Connection-Script
Посмотрите в 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.

Available Tools

1 tool

resolve_healthA

Check if DaVinci Resolve bridge is running. The bridge script must be running inside Resolve via Workspace > Scripts > DaVinciResolveBridge. If this returns an error, the bridge is not running.

ParametersJSON Schema

Name	Required	Description	Default
No parameters

TDQS

A4.4/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden of behavioral disclosure. It explicitly states the error behavior: 'If this returns an error, the bridge is not running.' This is key behavioral information. However, it does not disclose what a successful response contains or whether the tool has any side effects, though 'check' implies a read-only operation. Still, the error semantics are clearly and usefully disclosed.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is three sentences, each earning its place. The first sentence states the purpose, the second gives the setup prerequisite, and the third explains error interpretation. It is front-loaded with the core function and contains no filler or redundant phrases.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool is simple with no parameters, no output schema, and no siblings. The description covers what the tool checks and how to interpret an error. A minor gap is that it does not explicitly describe the success response, but for a health-check tool, the error condition is the most critical information. The description is otherwise complete for an agent to select and invoke the tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

This tool has zero parameters, so there is nothing to document. According to the guidelines, a baseline of 4 is appropriate when no parameters exist. The description does not need to add parameter-level detail, and it doesn't waste space on it.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states exactly what the tool does: 'Check if DaVinci Resolve bridge is running.' The verb 'check' and resource 'DaVinci Resolve bridge' are specific and unambiguous. Since there are no sibling tools, there is no need for differentiation, and the description is fully self-contained.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides clear usage context by explaining the prerequisite: the bridge script must be running inside Resolve via Workspace > Scripts > DaVinciResolveBridge. It also tells the agent how to interpret the result, which is effectively guidance for using the tool. There are no alternatives to contrast, so no exclusions are necessary, but it doesn't explicitly say 'use this when you need to verify connectivity.'

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

1 tool updatev1.2.5Sep 6, 2026
- First observedresolve_health

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4.1/5.0

Scored 2026-09-06 05:40 across 1 tool

Disambiguation5/5

Only one tool exists, so there is no possibility of confusion or overlapping purposes. The tool's purpose is unambiguous.

Naming Consistency5/5

The single tool name follows a clear verb_noun pattern (resolve_health), which is consistent and descriptive. With only one tool, naming consistency is inherently strong.

Tool Count2/5

A single health-check tool is far too few for a server presumably meant to bridge to DaVinci Resolve. Even as a minimal health-only server, one tool feels extremely thin and provides little value beyond a ping.

Completeness1/5

The server only provides a health check, with no ability to interact with DaVinci Resolve projects, timelines, renders, or any other meaningful operations. This is a severely incomplete surface for a bridge to a complex application.

Maintenance

ActivitySlowing

ResponsivenessNo issues

Resources

Need Help?

Related Servers

Related MCP Connectors

arsaze-mcp A
io.github.AnrosPrac
AI video editor for agents and humans: timeline, captions, color, audio and generation as MCP tools.
Image & Video Processing Multimedia Processing
241
ViewMax MCP A
io.github.bytevirts
Remote MCP for AI video, image, music and speech generation.
Audio Processing Image & Video Processing Speech Processing
141
CueFrameOAuth
ai.cueframe
Compose, edit and render video with your AI agent. Turn footage into finished edits with content-aware reframing, word-timed captions and motion graphics. Hosted MCP with OAuth sign-in; cloud processing uses credits.
Image & Video Processing Multimedia Processing
722
MaxVideoAI AOAuth
com.maxvideoai
Plan, compare, price, generate, and recover AI video from compatible MCP clients.
AI & Machine Learning Image & Video Processing
161

Related MCP Servers

resolve-mcp
Multimedia Processing Image & Video Processing
jenkinsm13
A
license
Not graded
quality
F
maintenance
Comprehensive MCP server for DaVinci Resolve with 295+ tools to control projects, timelines, editing, color grading, rendering, and more via natural language.
Updated 6 months ago (2026-04-18 00:51 UTC)
83 PyPI
6
MIT
davinci-resolve-mcp
Multimedia Processing Audio Processing
lordhoell
A
license
Not graded
quality
D
maintenance
An MCP server that exposes the complete DaVinci Resolve scripting API, enabling AI assistants to control DaVinci Resolve programmatically with over 440 tools for project management, timeline editing, color grading, rendering, and more.
Updated 6 months ago (2026-04-03 02:08 UTC)
13
MIT
davinci-resolve-mcp-free
Multimedia Processing Image & Video Processing
MDizzleZA
A
license
Not graded
quality
C
maintenance
Enables AI assistants to control DaVinci Resolve (Free and Studio) through natural language, providing 162 tools for timeline editing, color grading, rendering, and more. Includes local AI replacements for Studio-only features like voice isolation, background removal, and transcription.
Updated 2 months ago (2026-08-16 15:40 UTC)
MIT
davinci-resolve-mcp
Multimedia Processing Image & Video Processing Audio Processing
realmikeshu
A
license
Not graded
quality
Not graded
maintenance
Enables AI assistants to control DaVinci Resolve Studio via MCP, providing full scripting API coverage plus workflow helpers for editing, media organization, rendering, grading, and more.
Updated 2 months ago (2026-08-17 16:47 UTC)
5,556 npm
MIT

Davinc-Resolve-Local-Bridge-MCP

Что это?

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

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

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

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

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

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

Claude Desktop

Cursor

Devin

Claude Code

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

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

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

Архитектура

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Лицензия

Авторы

Available Tools

TDQS

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

resolve-mcp

davinci-resolve-mcp

davinci-resolve-mcp-free

davinci-resolve-mcp

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

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