DaVinci Resolve

AI エージェントに DaVinci Resolve で編集、カラーグレーディング、納品を任せましょう。すべての変更はチェックされます。

davinci-mcp は、DaVinci Resolve 向けの MCP サーバーです。Claude などの AI エージェントに、Resolve のスクリプト API 全体へのアクセスを提供します。17 の領域にわたる、型付けされた 299 個のアクションを利用できます。変更はすべて、完了として報告される前に Resolve 自体で検証されます。

クリック操作を任せられるアシスタントを求める編集者やカラリストにも、エージェントと Resolve の間に信頼できる橋渡しを求める開発者にも適しています。

動作を見る

実際の Claude エージェントにシンプルなメッセージを 4 つ与えると、オープン映画『Tears of Steel』から、52 秒のアクショントレーラーを編集しました。映像をインポートし、ビートに合わせて 33 のショットを配置し、タイトルカードを追加し、ティールとオレンジのカラーグレーディングを施して、レンダリングしました。この実行で演出された箇所はありません。以下の動画は 4 倍速です。

_{▶ YouTube でデモ全編を見る（39 秒）}

_{▶ エージェントが編集したトレーラーを YouTube で見る（52 秒）}

期待ではなく、検証済みです

• すべての書き込み後に Resolve から読み戻し、その結果として verified: true または false を返します。エージェントが、実際には行われていない変更を行ったと主張することはできません。
• dry_run を使うと、書き込みを適用せずにプレビューできます。
• 削除には同意が必要です。最初の呼び出しでは計画と confirm_token が返され、同じ呼び出しにトークンを付けて再度実行するまで、何も削除されません。
• 破壊的な編集の前に、タイムラインの安全スナップショットを作成します。
• すべての呼び出しを JSONL 監査ログに記録します。

信頼性

• 以下のベンチマークでは、20 件中 20 件のジョブに合格しました。コミュニティ MCP サーバーは 20 件中 13 件、davinci-mcp-professional は 20 件中 10 件でした。
• わずかに誤ったパラメーターは拒否せず修正します（fade_out → FadeOut、クリップ名だけの指定 → セレクター）。修正内容はすべて報告します。
• エラーは次のアクションにつながる内容です。正しいフィールドを提案し（「もしかして」）、適切なツールを示し、Resolve が拒否したレンダー設定を伝えます。

効率的

• batch_run を使うと、タイムラインからレンダーまでの 18 ステップなど、一連の処理全体をサーバー側で 1 回の呼び出しにまとめられます。
• クライアントはツールの読み込みを遅延するため、最初のターンで消費するコンテキストは約 32k トークンです。
• 返答とスキーマはコンパクトです。コミュニティサーバーと比べて、コストを 31 ％削減し、呼び出し回数を 60 ％削減します。

網羅的で拡張可能

• 17 のドメインに対応しています。プロジェクト、メディア、タイムライン、アイテム、カラー、Fusion、ギャラリー、オーディオ、レンダー、インターチェンジ、AI ツール、UI、アプリなどがあります。
• 1 回の呼び出しで実行できるワークフロー：conform_from_edl、deliver、build_vertical_reel、apply_look、title_overlay。
• 独自のレシピを使用できます。YAML テンプレートに加え、オプトインすると Python も利用できます。

デフォルトで安全

• ファイルアクセスは、許可したフォルダーに限定されます。
• サーバー自身の状態と設定、および Claude の設定ファイルには、常にアクセスできません。
• フォルダーのインポート時に、シンボリックリンクをたどることはありません。

ベンチマーク

ヘッドレスの Claude エージェント（Sonnet）が、稼働中の Resolve Studio 21.1 でポストプロダクションのジョブを 4 種類実行しました。各ジョブを 5 回ずつ実行しています。サーバーのコードを一度も見ていないエージェントが、各ジョブを作成しました。

• デイリーズ：1 日分の映像を記録して整理する；
• プロモ：音楽を付けたプロモを作成する；
• ルック：バージョンとスチルを使ってカラーグレーディングする；
• スポット QC：複製し、インターチェンジファイルを書き出し、範囲をレンダーする。

各チェックでは、テスト対象のサーバーを介さず、Resolve を直接読み取ります。すべてのエージェントは、同じ隔離されたハーネスで実行しました。方法と履歴の詳細 →

内蔵サーバーについて。 Resolve 21.1 には独自の MCP サーバーが付属しています。エージェントに任意の Python を Resolve 内で実行する run_script_unsafe という 1 つのツールを渡すため、コストを抑えられます。実行時間は短くなりますが、検証も、読み戻しも、監査も、スナップショットの作成も、削除前の確認も行われません。規模テスト（160 個のクリップ、4 つのタイムライン）では、マーカーを誤ったフレームに置いたうえで、ジョブが完了したと報告したことが一度ありました。davinci-mcp は、信頼できる変更を実現するために、わずかなコスト増を受け入れています。

エディターのように話しかける

Import the clips in ~/Footage/day03, sort interviews and B-roll into bins, and colour the circled takes green.

Build a 9:16 reel from these three shots, add subtitles from the audio, and render it for Instagram.

Conform this EDL against the media in ~/Rushes and deliver a ProRes master and an H.264 proxy.

Apply the show LUT to every shot of the timeline except the end card, and grab a still of the first shot.

Add a red marker at the start of every shot named "broll_" in Edit_03.

Duplicate the approved cut as "QC", export it as FCPXML and OTIO, and render 01:00:02:00 to 01:00:07:24.

仕組み

flowchart LR
    A["AI agent<br/>Claude, Cursor…"] -->|MCP call| V["Validate<br/>+ repair"]
    V --> C["Consent<br/>deletes only"]
    C --> N["Snapshot<br/>destructive only"]
    N --> X["Call Resolve<br/>one thread"]
    X <-->|scripting API| D[("DaVinci<br/>Resolve")]
    X --> R["Read back<br/>→ receipt"]
    R --> L["Audit log"]
    R -->|"verified: true / false"| A

1. 検証。 エージェントは {"op": {"action": ..., ...}} を指定して timeline_write などのドメインツールを呼び出し、パラメーターが型付きスキーマに照らして検証されます。ほぼ正しいパラメーターは修正され、修正内容はその都度報告されます。
2. 同意とスナップショット。 削除は確認されるまでプランの段階で保留され、破壊的な編集の前にはスナップショットが作成されます。
3. Resolve の呼び出し。 呼び出しは単一のエグゼキュータースレッドで実行されます。Resolve が呼び出されるのはこのスレッドだけです。
4. 結果の読み戻し。 サーバーは Resolve から結果を読み戻し、verified を含む確認レシートを返します。時間のかかるレンダーはジョブになり、エージェントは完了を待つことができます。

ツール

52 個のツールがあります。ドメインツールの名前は <domain>_read、<domain>_write、<domain>_delete で、{"op": {"action": ..., ...}} を受け取ります。これらを合わせると約 300 個のアクションを利用できます。読み取りには副作用がなく、書き込みは検証済みの確認レシートを返し、削除の前には確認を求めます。

• resolve_status - 接続状態、Resolve のバージョンとエディション、現在のプロジェクト、タイムライン、ページ。
• describe_action - 1 つまたは複数のアクションの簡潔なパラメータースキーマ。
• search_api - Resolve 21.1 のスクリプティング API を名前または説明で検索します。
• batch_run - 複数のツール呼び出しをサーバー側で 1 回の呼び出しにまとめて実行します。バッチ全体に対して確認は 1 回です。
• workflow_write - 1 回の呼び出しで実行するジョブ：conform_from_edl、deliver、build_vertical_reel、apply_look、title_overlay。
• recipe_list / recipe_run - YAML または Python のレシピを一覧表示、実行します。すべてのステップが検証、確認、監査されます。
• project_read / project_write / project_delete - プロジェクト、フォルダー、データベース、設定、設定プリセット。作成、読み込み、保存、アーカイブ、インポート、エクスポートに対応します。
• media_read / media_write / media_delete - メディアプールとストレージ：インポート、ビン、再リンク、プロキシ、メタデータ、マーカー、フラグ、マルチカム、マット、オーディオ同期。
• timeline_read / timeline_write / timeline_delete - タイムライン、トラック、マーカー、再生ヘッド、コンパウンドクリップと Fusion クリップ、インポート、エクスポート。
• item_read / item_write / item_delete - タイムラインアイテム：プロパティ、速度、フェード、テイク、フラグ、カラー、マーカー、トランジション、手ぶれ補正。
• color_read / color_write / color_delete - ノードグラフ、CDL、LUT、バージョン、カラーグループ、DRX グレード、DCTL。
• fusion_read / fusion_write / fusion_delete - Fusion コンポとツール：追加、接続、入力、キーフレーム、エクスプレッション、Text+ タイトル、設定、フューズ。
• gallery_read / gallery_write / gallery_delete - スチルアルバム：取得、インポート、エクスポート、ラベル付け。
• audio_read / audio_write - ラウドネス分析、無音検出、ノーマライズ、音声分離、Fairlight プリセット、オーディオマッピング。
• render_read / render_write / render_delete - フォーマット、コーデック、プリセット、レンダージョブ。タイムラインまたは範囲のレンダリング、Quick Export。
• interchange_read / interchange_write - EDL、FCPXML、OTIO、マーカー CSV、.cube LUT ファイル。Resolve を介さずに読み書きします。
• ai_read / ai_write / ai_delete - 音声の文字起こし、音声からの字幕生成、シーンカット検出、Smart Reframe、オーディオ分類、IntelliSearch。
• vision_read - エージェントが映像を確認できるよう、フレームやコンタクトシートをエクスポートまたはスクリーンショットで取得します。
• ui_read / ui_write / ui_delete - API では対応できない一部の操作に使う、ページ、メニュー、キーボードショートカット。
• app_read / app_write / app_delete - Resolve アプリの情報、レイアウトプリセット、キーフレームモード、終了。
• snapshot_list / snapshot_write - 破壊的な編集の前に自動作成される、タイムラインまたはプロジェクトの安全用コピー。
• job_status / job_wait / job_list / job_cancel - レンダーや分析など、時間のかかる処理をジョブとして実行します。
• code_delete - Resolve 内での run_lua と run_python。デフォルトでは無効で、実行のたびに確認を求めるエスケープハッチです。

インストール

uv tool install davinci-mcp

pipx install davinci-mcp と pip install davinci-mcp も使用できます。

davinci-mcp doctor

doctor は Resolve に接続できることを確認し、バージョン、エディション、チャンネルを報告します。

davinci-mcp install --target claude-code

claude mcp add davinci-mcp -- davinci-mcp serve

davinci-mcp install --target claude-desktop

{
  "mcpServers": {
    "davinci-mcp": { "command": "davinci-mcp", "args": ["serve"] }
  }
}

{
  "mcpServers": {
    "davinci-mcp": { "command": "davinci-mcp", "args": ["serve"] }
  }
}

{
  "servers": {
    "davinci-mcp": { "type": "stdio", "command": "davinci-mcp", "args": ["serve"] }
  }
}

任意のファイル ~/.config/davinci-mcp/config.toml に設定を保存します。任意のキーは、DAVINCI_MCP_<SECTION>__<KEY> 環境変数で上書きできます。

[safety]
allowed_roots = ["~/Movies", "~/Projects"]  # files outside these are refused (default: your home)
auto_snapshot = "destructive"               # "off" | "destructive" | "all"

[recipes]
allow_python = false                        # Python recipes run arbitrary code: opt in

このファイルは作成するまで存在しません。作成しない場合は、以下のデフォルト値が適用されます。不明なキーや、誤ったセクションにあるキーがあると、検証エラーでサーバーが停止します。環境変数では、リストを [~/Movies,~/Footage] の形式で記述します。

よくある質問

問題の報告やプルリクエストを歓迎します。docs/domain-guide.mdでは、アクションの追加方法として、パラメーターモデル、ハンドラー、読み戻しチェック、テストについて説明しています。残りはそこから生成されます。

uv sync
uv run pytest
uv run ruff check . && uv run pyright

クレジット

• デモ映像：Tears of Steel、© Blender Foundation | mango.blender.org、CC-BY 3.0。
• デモ音楽：Kevin MacLeod 作曲の Five Armies（incompetech.com）、CC-BY 4.0。

davinci-mcp は独立したプロジェクトです。Blackmagic Design とは提携しておらず、同社から承認や後援を受けていません。DaVinci Resolve は Blackmagic Design Pty. Ltd. の商標です。

サポート

davinci-mcp は無料のオープンソースです。編集作業の時間短縮に役立ったら、コーヒーをごちそうしていただけると幸いです。

Delanoe Pirard（Aedelon）作成 · Apache 2.0