DaVinci Resolve MCP Server

English | 简体中文

ローカルブラウザのコントロールパネルがサーバーに同梱されており、Resolve の状態の検査、ソースセーフな解析の実行、解析済みクリップやショットの詳細調査、解析出力のインライン編集が可能です。詳細はコントロールパネルガイドをご覧ください。

クイックスタート

npx davinci-resolve-mcp setup

接続する前に、DaVinci Resolve Studio を開き、Preferences > General > External scripting using を Local に設定してください。（無料版ではその設定は役に立ちません — 下記の無料版を参照してください。）npm ランチャーは、ユーザーのアプリケーションデータディレクトリ配下に管理されたコピーをインストールし、その後、ユニバーサル Python インストーラーを実行します。インストーラーは仮想環境を作成し、Resolve のパスを検出し、Claude Desktop、Claude Code、Cursor、VS Code、Windsurf、Zed、Continue、Cline、Roo Code、OpenCode、Codex CLI、JetBrains IDEs を設定できます。

ソースインストールの場合:

git clone https://github.com/samuelgursky/davinci-resolve-mcp.git
cd davinci-resolve-mcp
python install.py

プラットフォームのパス、クライアント固有の設定、手動セットアップについては、インストールと設定 を参照してください。

インストーラーとサーバーは、MCP の更新について GitHub の最新リリースを確認します。チェックはベストエフォートで、スロットルが適用されます。サーバーがプロンプトのために MCP の起動をブロックすることはありません。インストーラーは、プロンプト表示、スヌーズ、リリースの無視、チェックの無効化、またはクリーンな git チェックアウトに対するオプトインの安全な自動更新を適用できます。

無料版（アプリ内ブリッジ）

Blackmagic は外部スクリプティングを Studio に限定しています。無料版では、設定がどうであれ、scriptapp("Resolve") は外部プロセスを拒否します。Workspace ▸ Scripts メニューは制限されていません。そこから起動されたスクリプトは、どのエディションでもライブの resolve オブジェクトを渡されるため、サーバーは Resolve 内部で実行され、認証付きループバックリスナーを介してそれを再エクスポートする小さなスクリプトを通じて無料版に到達できます。

python scripts/install_resolve_bridge.py
# restart Resolve, open a project, then: Workspace > Scripts > resolve_bridge

そのリスナーが起動している間、外部スクリプティングが利用できない場合は自動的に使用されます — 環境変数は不要です。DAVINCI_RESOLVE_BRIDGE=1 を設定すると、ブリッジが強制されます。それが試行される唯一のトランスポートになるため、応答しなくなったブリッジは、静かに別のトランスポートにフォールバックするのではなく、それ自体の障害を報告します。ブリッジに依存する予定がある場合は、これを使用してください。

macOS では、Resolve は Python 3 を正確に 2 か所で探します。PYTHON3HOME 環境変数、次に /usr/local/bin/python3 です。Homebrew、pyenv、uv、conda はどちらにも該当しないため、スクリプトはメニューに静かに表示されません。python.org のインストールは、そのインストーラーが /usr/local/bin/python3 を作成するため機能しますが、それを用意する必要はありません。既に持っているインタープリターを Resolve に指定してください。sudo は不要です。

launchctl setenv PYTHON3HOME "$(python3 -c 'import sys; print(sys.prefix)')"

export ではなく launchctl setenv を使用してください — Resolve は Dock から起動されるため、シェルの環境を認識しません。その後、Resolve を再起動してください。Lua カナリアも一緒にインストールされるため、「Python が検出されません」というメッセージとフォルダーの誤りを区別できます。

macOS では無料版 21.0.3.7 と Studio 19.1.3.7 で検証済みです。v2.70.1 で追加された Windows パス（issue #106）は未検証のままリリースされましたが、その後の無料版 21.0.1.11（issue #109）と無料版 21.0.3.7（issue #112）のレポートにより、ブリッジが Windows 11 の %PROGRAMDATA% と %APPDATA% の両方にインストール、リスト表示、提供されることが示され、これらのパスは推測ではなく確認されたものになりました。Linux も確認されています。無料版 20.3.2.9（issue #129、Fedora 43）のレポートでは、ブリッジが ~/.local/share/DaVinciResolve/Fusion/Scripts/Utility にインストールされ、システム Python に対してリスト表示され（Linux にはこの検出問題はありません）、エンドツーエンドで提供されることが示されています。もはや推測に依存しているプラットフォームはありません。macOS は直接検証され、Windows と Linux はユーザーレポートに基づいています。

ブリッジは提供している間、ポートを保持することに注意してください。v2.70.3 より前では、Windows ブリッジが Resolve より長く生き残り、次のセッションのリスナーをブロックする可能性がありました。古いビルドを使用していてブリッジが応答しなくなった場合は、ポートをまだ保持している古い fuscript.exe がないか確認してください。

これは文書化されたアプリ内パスであり、ライセンス回避ではありませんが、Blackmagic がこれを閉じる可能性があります — サポートされなくなるまではサポートされる層として扱ってください。ループバックのみ、HMAC 署名付きリクエスト、ワンタイムナンス。

ローカルコントロールパネル

リポジトリのルートからシングルユーザーのローカルコントロールパネルを起動します:

venv/bin/python -m src.control_panel

このコマンドは localhost サーバーを起動し、ブラウザでコントロールパネルを開きます。AI コーディングエージェントにこれを行わせるには、「Open the Resolve MCP control panel for this repo.」 と依頼してください。エージェントは、Python 環境がすでにアクティブでない限り、venv/bin/python -m src.control_panel を使用する必要があります。永続化された解析ジョブは、スライスが正常に完了するとローカル検索インデックスを自動的に更新します。手動の Build Index アクションは、既存のレポートから再構築するためのものです。

サーバーモード

コンパウンドサーバーは、特にメソッドごとに 1 つのツールという細かいサーフェスが必要でない限り推奨されます。

高度なサーバー — スクリプティング API を超えて (オプション、Node)

同じパッケージには、2 つ目のオプションの MCP サーバー davinci-resolve-advanced-mcp (bin bin/davinci-resolve-advanced-mcp.mjs) が同梱されています。Python サーバーが承認されたスクリプティング API を介してライブの Resolve を操作するのに対し、高度なサーバーは API ではできないことを行います — Resolve のファイル (.drp / .drt / .drx) を読み書きし、Resolve を実行せずに DB/XML レベルの変更を適用するため、クラウドまたはローカルで実行できます。18 のツール: drp、drt、drx (クリップごとのグレードコーデック に加え、決定的なオフライングレーディング/QC カタログ — カメラ内 + カメラ間のスキン (v2 スキンライン指標) + Bロール + ニュートラルパッチの WB マッチング、参照へのマッチング、彩度/ブラックバランス、コントラスト正規化、ASC CDL インポート、ロスレスグレード転送 + シーズンルックの作成、名前付き LUT の適用、スコープ読み取り + 意図タグ、グレード検証、ディスプレイ参照フレーム抽出、ブロードキャスト法適合 QC)、offline_ref、conform (フレームオラクルコンフォーム/リリンク QC + 系統)、color_trace (再コンフォーム全体でグレードを引き継ぐ)、fusion、audio_plan、fairlight (バスルーティング)、audio、project_read、project_db、pipeline (DB を真実とするパイプライン: YAML プロジェクト仕様を正規の SQLite DB にコンパイルし、ゲート、来歴、意図↔実際のドリフト検出を備えたステージを実行します)、capabilities、deliverable (デリバラブル QC / コンプライアンス)、media (メディアフロントエンド / AE インジェスト)、editorial (編集の整合性 / チェンジリスト)、provenance (来歴 / 監査 / エピソードレポート)。また、サーバーとして起動するだけでなく、ライブラリとして (インポート可能なエンジン API) 利用することもできます。

DRX グレードの書き込みは、Resolve Studio に対してライブキャリブレーションされています: グレードパラメータはデフォルトで Resolve の画面上のパネル単位を取ります (space: 'ui' | 'drx')。構造的な書き込み (パワーウィンドウ、クオリファイア、HDR ゾーン、HSL カーブ、ColorSlice、ブラー/キー/モーションエフェクト) は、パネルの読み戻しで検証されます — 各コントロールのステータスは resolve-advanced/vendor/drx-parameters/CALIBRATION-STATUS.md にあります。また、UI のみのギャップも解消します: プログラムによる「Cleanup Node Graph」 (drx relayout は 1 クリップ用、project_db relayout_node_graphs はプロジェクト全体用) — ノードレイアウトが整理され、グレードコンテンツはバイト単位で保持されます。

ライブサーバーと一緒に追加します (両方とも 1 つの npm install に同梱されています):

{
  "mcpServers": {
    "davinci-resolve": { "command": "<python>", "args": ["<path>/src/server.py"] },
    "davinci-resolve-advanced": { "command": "node", "args": ["<path>/bin/davinci-resolve-advanced-mcp.mjs"] }
  }
}

install.py は両方のエントリを表示します。コアは必須のネイティブモジュールがない純粋な JS/MIT です。いくつかの機能はユーザーがインストールしたツールを必要とします (audio には ffmpeg、一部のパスには sharp/better-sqlite3) — ライブステータスとインストールのヒントについては、capabilities ツールを呼び出してください。

Bradford Post Assistant — マネージドアプリケーション (クローズドベータ)

メンテナーは、このオープンな基盤の上にデスクトップアプリケーションである Bradford Post Assistant も構築しています。MCP サーバーがエージェントに手を与えるのに対し、Post Assistant はその周りで働くコパイロットです — クライアントの素材がワークステーションから出ることはない、ポストプロダクション向けのオンデバイス AI アシスタントです:

• ポストプロダクションコパイロット — DaVinci Resolve のそばに配置され、セッションをライブで監視するデスクトップアプリ (API 呼び出しだけでなく、タイムライン、グレード、フレームも監視)。埋め込み AI アシスタントとエージェントランタイム、ローカルメディア解析 (文字起こし、フレーム解析、編集インテリジェンス)、アプリ内コンフォーム QC を備えています。

• メモリ — 永続的で暗号化されたオンデバイスアシスタントメモリに加え、パイプラインのデコードされたファクトからマイニングされたエピソード横断学習 (シーズンルックのドリフト、カメラごとの補正事前分布、ヒーローフレームライブラリ、コンフォームパスマップの再利用)。蓄積は管理され、レビュー済みインサイトのワークフローが用意されています。

• 設計による自己完結型 — Post Assistant はすべてを自ら配線します: Resolve 制御用のこの MCP、拡張サービス用の Bradford API、そして選択した LLM プロバイダー。手動で設定するものはなく、管理する別のクライアントもなく、アプリは署名付き自動更新でそれ自体 (および同梱の MCP) を最新に保ちます。

• 拡張されたプロフェッショナルツールセット — ライブプロジェクトでのグレード修正、22 以上のアダプティブグレードファミリー、キュレーションされたルックスライブラリ、デリバリー仕様の検証、編集ペーシング/クリーンアップ解析、自然言語によるカラーディレクション、Fusion コンポジションの作成 — これらはマネージド Bradford API を通じて提供されます。

• プロダクションワークフロー — 生のツールを完成された現実のフロー (ターンオーバー → コンフォーム → QC → デリバリー、シーズンルックの引き継ぎ、エピソードレポート) に合成します。クライアント向けの現場が期待するガードレールと承認を備えています。

現在クローズドベータです — bradfordoperations.com/software/post-assistant でアクセスをリクエストできます。オープンソースのサーバーは独立して完全かつ完全に機能します。

できること

"List all projects and open the one called 'My Film'"
"Create a timeline called 'Assembly Cut' from all clips in the current bin"
"Build a multicam prep timeline from selected camera angles and preserve source media"
"Detect 2-pops or slate claps and suggest record offsets for sync prep"
"Publish analysis summaries, keywords, people, and slate hints into Resolve clip metadata"
"Probe this timeline for gaps, overlaps, missing media, and source frame ranges"
"Safely import this image sequence, organize it into bins, and normalize clip metadata"
"Build a ProRes 422 HQ render plan, validate the settings, and queue the job"
"Copy review markers from the timeline to the selected clip and export a review report"
"Snapshot this clip's grade, validate a CDL update, and export a temp LUT"
"Create a Fusion TextPlus overlay on the selected clip and verify graph connections"
"Report audio channel mappings, voice isolation availability, and subtitle support"
"Install this MCP-marked DCTL or script, classify refresh/restart needs, then remove it"

コア機能

オプションの追加機能

コアインストールは意図的に小さくしています: Python、ffmpeg、およびResolveスクリプトAPI。一部の機能にはさらに多くのものが必要です。それぞれの機能は、推測に陥るのではなく、専用のインストール行で正直に拒否します — 捏造されたテンポやでっち上げられたレベルは、自信に満ちた誤った出力を生み出し、機能がないことよりも悪いからです。

python scripts/doctor.py を実行すると、これらのうちどれを保持しているか確認できます。

media_analysisアクションのcapabilitiesは、分析スタックを詳細に報告し、欠けている各要素が何を可能にするかを示します。

ここに含まれるものはバンドルされていません。 モデルの重みは、それを読み込むコードとは別に独自のライセンスを持っています。商用利用前に確認してください。

これが行わないこと

ツールの限界を知ることは、その機能を知ることと同じくらい価値があります。プロジェクトの途中で気づくよりも、ここで読む方が手間がかかりません。

分析されたが検証できないものは未検証として報告され、決して「問題なし」に含められません。空の結果は「何も見つからなかった」を意味し、「見つけるものがない」を意味しません。

ソースメディアの安全性

このプロジェクトはカメラオリジナルとソースメディアを不変として扱います。解析ツールはソースファイルを読み取り、サイドカー、スクラッチ、またはプロジェクト解析ディレクトリにのみレポートを書き込みます。確定したメタデータの公開はResolveのプロジェクトデータベースにのみ書き込みます。サーバーは、ユーザーが明示的に要求しない限り、ソースメディアを変更、トランスコード、プロキシ化、または派生物を作成してはなりません。詳細なソース安全ワークフローについては、メディア解析ガイドを参照してください。

セキュリティ体制

デフォルトサーバーは、MCPクライアントによって起動されるローカルstdioプロセスであり、ネットワークリスナーや組み込みのマルチユーザー認証表面を公開しません。ツールメタデータには、読み取り専用、破壊的、冪等、および外部リソース操作のためのMCPクライアント安全性ヒントが含まれます。運用上の境界、確認ガイダンス、脆弱性報告については、セキュリティポリシーを参照してください。

主要統計

メソッドごとのステータスについては、APIカバレッジとテスト結果 を参照してください。現在のワークフローサポートについては、カーネルアクションカバレッジ を参照してください。

analyze_media はデフォルトで直接実行され、分析ルート配下に検査可能なレポート/アーティファクトを保持し、host_chat_paths プロトコルを介してホストチャットの視覚分析を要求し（analyze は絶対フレームパスと JSON スキーマを返します。ホストチャットは各フレームを画像として読み取り、media_analysis(action="commit_vision", ...) を呼び出して確定します）、設定されたローカルバックエンド経由で文字起こしを実行し、分析サマリーとソースタイムの Media Pool クリップマーカーを Resolve プロジェクトに書き戻します。include_visuals=false、include_transcription=false、publish_metadata=false、timed_markers=no、または dry_run=true を渡す場合のみ、これらのデフォルト動作をオプトアウトできます。commit_vision をスキップすると、実行は pending_host_vision_analysis のまま残ります — これは失敗モードとして表面化され、静かにダウングレードされることはありません。

ドキュメント

拡張機能のオーサリングリファレンスは docs/authoring にあります。Resolve開発者パッケージのノートは docs/notes と docs/integrations にあります。プロンプトレシピは examples にあります。

要件

• macOS、Windows、Linux 上の DaVinci Resolve 18.5+。Studio は外部スクリプトを直接サポートしています。無料版（free edition） はサポートしていません — Blackmagic は外部スクリプトを Studio に限定しているためです — ただし、アプリ内ブリッジ を介して到達可能です。このブリッジは Resolve 内で、ゲートされていない Workspace ▸ Scripts メニューから実行されます。

• Python 3.10+（3.10-3.12 が最もリスクの低い範囲です）。Python 3.13/3.14 も最近の Resolve ビルドで動作します（Studio 20.3.2 で検証済み）。古いビルドでは 3.13+ での接続に失敗する可能性があるため、その場合は 3.10-3.12 を使用してください。

• Resolve の外部スクリプトを Local（Studio）に設定します。無料版ではこの設定は効果がないため、代わりに アプリ内ブリッジ を使用してください。

Resolve 19.1.3 が互換性のベースラインです。Resolve 20.x のスクリプト呼び出しは追加型で、バージョンガードされ、20.3.2 でライブテストされています。Resolve 21.0 のスクリプト追加機能（オーディオ分類、話者検出文字起こし、IntelliSearch、スレート分析、モーションデブラー、音声生成、セッションのバックグラウンドタスク制御）はランタイム機能検出の背後に公開されているため、古いビルドでは動作せず、Resolve 21+ で自動的に有効になります。これらは Studio 21.0.2.4 でライブテストされています — Resolve 21 差分 を参照してください。AnalyzeForIntellisearch、AnalyzeForSlate、GenerateSpeech はそれぞれ別途ダウンロードが必要な AI Extras パックを必要とし、Resolve はパック不足を一貫して報告しないため（一部は False を返し、他はエラー文字列を返す）、これらのアクションは推測ではなく Resolve から提供された理由とともに success: false を報告します。

開発

python src/server.py          # Compound server
python src/server.py --full   # Granular server
venv/bin/python tests/test_import.py
venv/bin/python scripts/audit_api_parity.py

リリースと検証のルールは docs/process/release-process.md にあります。このリポジトリで作業する AI エージェントは AGENTS.md から始める必要があります。Claude Code ユーザーは CLAUDE.md も読むことができます。これも同じ標準手順を指しています。

ライセンス

MIT

著者

Samuel Gursky (samgursky@gmail.com)

• GitHub: github.com/samuelgursky

謝辞

• DaVinci Resolve とそのスクリプティング API を提供してくれた Blackmagic Design

• AI アシスタントの統合を可能にしてくれた Model Context Protocol チーム