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 は、AIアシスタントにDaVinci Resolveの完全な制御を提供するModel Context Protocol (MCP)サーバーです。ResolveスクリプティングAPI全体（プロジェクト、タイムライン、メディア、Fusion、カラーグレーディング、レンダリングなど）をカバーする215のツールを公開します。

仕組み

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のプロセス内部で実行され、ResolveスクリプティングAPIへの完全なアクセスを提供します（外部スクリプティングをブロックするFree版でも動作します）。MCPサーバーは別プロセスとして実行され、localhost HTTP経由でツール呼び出しをブリッジにプロキシします。

Related MCP server: davinci-resolve-mcp

クイックスタート

前提条件

DaVinci Resolve 18.5+（FreeまたはStudio）
お使いのマシンにPython 3.10+
MCP互換のAIアシスタント（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 — AIアシスタントの設定

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 に移動
コンソール（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 — 使い始める

AIアシスタントに次のように尋ねます：

「DaVinci Resolveが接続されているか確認して」

アシスタントが resolve_status ツールを呼び出して結果を報告します。次に試してみてください：

「'My Video' という名前の1920x1080 30fpsの新規プロジェクトを作成して、タイムラインを追加して」

アーキテクチャ

ブリッジスクリプト（`bridge/Bridge-Connection-Script.py`）

Workspace > ScriptsメニューからDaVinci Resolveの内部で実行されるPythonスクリプトです。次のことを行います：

Fusionのグローバルからライブの resolve オブジェクトを取得
127.0.0.1:8787 でHTTPサーバーを起動
3つのエンドポイントを公開：
- GET /health — ブリッジが稼働しているか確認
- GET /actions — 利用可能なすべてのアクション名を一覧表示
- POST /action — パラメータ付きでアクションを名前で実行
ブロッキングの serve_forever() 呼び出しで常駐
起動前に同じポートの以前のインスタンスを終了

MCPサーバー（`mcp_server/server.py`）

スタンドアロンのMCPサーバーです。次のことを行います：

localhost上のHTTPでブリッジに接続
ブリッジの /actions エンドポイントから215すべてのアクションを自動検出
各アクションを resolve_ プレフィックス付きのMCPツールとして公開
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`	—	バーンインプリセットを一覧表示
`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`	OSのファイルブラウザでファイルを表示

メディアプール（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ツール）

ツール	パラメータ	説明
`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ツール）

ツール	パラメータ	説明
`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?`, ...	マジックマスクを作成
`resolve_regenerate_magic_mask`	`trackType?`, ...	マジックマスクを再生成
`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ツール）

Tool	Parameters	Description
`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`	2つのノードを接続
`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ツール）

Tool	Parameters	Description
`resolve_get_gallery_still_albums`	—	ギャラリーのスチルアルバムを一覧表示
`resolve_get_gallery_powergrade_albums`	—	PowerGrade アルバムを一覧表示
`resolve_create_gallery_still_album`	—	スチルアルバムを作成
`resolve_create_powergrade_album`	—	PowerGrade アルバムを作成

カラー / ノード（7ツール）

Tool	Parameters	Description
`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ツール）

Tool	Parameters	Description
`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ツール）

Tool	Parameters	Description
`resolve_generate_speech`	`text`, `voice?`	AI 音声オーディオを生成

スペシャル（1ツール）

Tool	Parameters	Description
`resolve_create_hand_animation`	`imagePath`, `...`	手描きアニメーションを作成（Daniel Batal のテクニック）

トラブルシューティング

ブリッジが起動しない

DaVinci Resolve が実行中で、プロジェクトが開いていることを確認してください
エラーメッセージがないかコンソール（Workspace → Console）を確認してください
DaVinci Resolve を再起動してください — 起動時にのみ Scripts フォルダをスキャンします

「Resolve Bridge に接続できない」

Resolve 内で Workspace → Scripts → Bridge-Connection-Script を実行したことを確認してください
コンソールに [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 サーバーのみ。ブリッジは純粋な stdlib を使用）
Resolve バージョン: 18.5+（21.0.4.5 でテスト済み）
Python: MCP サーバーは 3.10+。ブリッジは Resolve の組み込み Python を使用

ライセンス

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 — AIアシスタントの設定

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`）