DaVinci Resolve MCP サーバー：AI アシスタントによるスクリプト API 制御

スクリプト API ブリッジ

このリポジトリは、DaVinci Resolve Studio の公式スクリプト API を AI アシスタントに公開する MCP サーバーの Python 実装です。API を完全にカバーし、349 メソッドすべてに対応し、編集、メディアプール整理、レンダー設定、レビューマーカー、グレーディング、Fusion、Fairlight、プロジェクトライフサイクルタスクのための保護付きワークフローヘルパーを提供します。サーバーには、Resolve の状態を検査し、ソースセーフな分析を実行し、分析出力をインラインで編集するためのローカルブラウザコントロールパネルが同梱されています。README はそのパネルの専用ガイドを参照しています。

2 つのサーバーモード

サーバーには 2 つのモードがあります。デフォルトの複合モードは src/server.py で起動し、関連する Resolve 操作をアクションパラメータの背後にまとめた 34 のツールを公開し、コンテキスト使用量を抑えます。完全な詳細モードは src/server.py --full または src/resolve_mcp_server.py で起動し、Resolve API メソッドごとに 1 つずつ、341 のツールを公開します。README は、メソッドごとに 1 つのツールの表面が特に必要な場合を除き、複合サーバーを推奨しています。どちらのモードも、公式スクリプト API を介したライブ Resolve インスタンス向けです。

無料版への対応

外部スクリプトは Studio に限定されています。無料版では、scriptapp("Resolve") は設定に関係なく外部プロセスを拒否します。ただし、Workspace > Scripts メニューは制限されていないため、プロジェクトは Resolve 内で実行され、認証されたループバックリスナーを介して resolve オブジェクトを再エクスポートするブリッジスクリプトを提供します。macOS では、Resolve が python.org のインストールからの .py スクリプトのみを列挙するため、ブリッジにはフレームワーク Python が必要です。README には、macOS の無料版 21.0.3.7 と Studio 19.1.3.7 での検証が記載されており、Windows パスはユーザーレポートによって後に確認されました。

オフラインのコンパニオンサーバー

同じ npm パッケージには、Node で書かれた 2 つ目のオプションの MCP サーバー davinci-resolve-advanced-mcp が含まれています。Python サーバーとは異なり、実行中の Resolve インスタンスは不要で、.drp、.drt、.drx ファイルを直接読み取りおよび編集し、データベースおよび XML レベルの変更を適用できます。コンフォーム、カラートレース、オーディオプランニング、YAML 仕様を SQLite データベースにコンパイルするパイプラインなどのタスクのための 18 のツールを提供します。README は、DRX グレードの書き込みが Resolve Studio に対してライブキャリブレーションされており、構造的な書き込みがパネルリードバックで検証され、コントロールごとのステータスがキャリブレーションファイルにあると述べています。

このプロジェクトがやらないこと

README は境界を明確にしています。ソースメディアは不変として扱われ、分析ツールはサイドカー、スクラッチ、またはプロジェクト分析ディレクトリにのみ書き込み、確認されたメタデータの公開は Resolve のプロジェクトデータベースにのみ行われます。サーバーはベストテイクの選択、音楽へのカット、編集の良し悪しの判断を行いません。分析されたが検証できない結果は未検証として報告され、空の結果は何も見つからなかったことを意味し、見つけるものがないことを意味しません。破壊的なアクションは、計画、レビュー、確認の順序に従います。

インストール、追加機能、要件

クイックスタートでは npx davinci-resolve-mcp setup を使用し、管理されたコピーをインストールして、複数のクライアント IDE を設定する Python インストーラーを実行します。ソースインストールでは、git clone と python install.py が文書化されています。コアインストールは意図的に小さく保たれており、Python、ffmpeg、Resolve スクリプト API のみを含みます。numpy、librosa、openai-whisper などのオプションの追加機能により、追加の分析機能が解放されます。欠落している追加機能はそれぞれ、推測に陥るのではなく、インストール行を正直に拒否します。要件は、DaVinci Resolve 18.5 以降、Python 3.10 から 3.12 が最もリスクの低い範囲であり、Studio では外部スクリプトを Local に設定する必要があります。

テストカバレッジとライセンス

主要な統計表には、API メソッド 349 件中 349 件がカバーされ、338 件がライブテストされ、その 100% の合格率が記載されています。テストは Resolve 19.1.3 Studio、20.3.2 Studio、21.0.2 Studio に対して実行されました。Resolve 21 の追加機能はランタイム機能検出によって保護されています。このプロジェクトは MIT ライセンスで公開され、著作権は DaVinci Resolve MCP Contributors と Bradford Operations LLC に帰属します。このライセンスは、使用、コピー、変更、マージ、公開、配布、サブライセンス、および販売の権限を許可しますが、ソフトウェアは「現状のまま」提供され、保証はなく、責任を放棄します。

編集部の結論

このリポジトリは、スクリプト API メソッド 349 件中 349 件をカバーし、338 件をライブテスト済みと報告しており、MIT ライセンスで公開されています。

公式情報源

1. Official README
2. Project repository
3. Release notes