davinci-resolve-mcp MCP — ユースケース, インストール & ライブデモ

なぜ使うのか

主な機能

27ツールでResolve APIメソッド324件中324件をカバー（100%）
ユニバーサルインストーラーがClaude Desktop/Code、Cursor、VS Code、Windsurf、Zed、JetBrainsを自動設定
タイムライン操作：トラック、マーカー、クリップ、ジェネレーター、タイトル
クリップ単位のトランスフォーム、クロップ、コンポジット、リタイム、キーフレーム
FusionノードグラフAPIによるモーショングラフィックス自動化

ライブデモ

実際の動作

davinci-resolve.replay ▶ 準備完了

0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "davinci-resolve": {
      "command": "uvx",
      "args": [
        "davinci-resolve-mcp"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "davinci-resolve": {
      "command": "uvx",
      "args": [
        "davinci-resolve-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "davinci-resolve": {
      "command": "uvx",
      "args": [
        "davinci-resolve-mcp"
      ],
      "_inferred": true
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "davinci-resolve": {
      "command": "uvx",
      "args": [
        "davinci-resolve-mcp"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "davinci-resolve",
      "command": "uvx",
      "args": [
        "davinci-resolve-mcp"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json

{
  "context_servers": {
    "davinci-resolve": {
      "command": {
        "path": "uvx",
        "args": [
          "davinci-resolve-mcp"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add davinci-resolve -- uvx davinci-resolve-mcp

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方： davinci-resolve-mcp

スクリプトと素材フォルダからラフカットを作成する

👤 トーキングヘッドコンテンツを制作する映像エディター ⏱ ~20 min intermediate

使うタイミング： 2時間分のBロールと3ページの台本があり、空のタイムラインからスタートしたくない場合に使います。

前提条件

DaVinci Resolve Studio 18.5以降が起動していること — 一度購入（$295） — 無料版にはスクリプトAPIがありません
Resolveの設定：システム > 一般 > 外部スクリプト使用：Local — 設定変更後、Resolveを再起動してください
ユニバーサルインストーラーでMCPをインストール済みであること — git clone samuelgursky/davinci-resolve-mcp && python install.py

フロー

プロジェクトを作成しメディアをインポート

Create a new project 'EP04_RoughCut', 1080p24, and import every .mov in ~/Footage/EP04 into a Media Pool folder called 'B-roll'.✓ コピーしました

→ フォルダにメディアが格納された状態でプロジェクトが開く
台本のビートに合わせてタイムラインを構築

Create a new timeline. For each paragraph in ~/Footage/EP04/script.md, add a 6-second marker on track V2 labeled with the first 5 words.✓ コピーしました

→ ビートマーカー付きのタイムライン
各マーカーにBロールを配置

At each marker, pick the closest-matching B-roll clip by filename keyword and place it on V1 at that marker.✓ コピーしました

→ カットが目に見える形で組み上がる

結果： 1時間かかる作業が5分で完了し、手動で仕上げられるラフカットができます。

注意点

ファイル名ベースのマッチングは精度が低い — クリップにわかりやすいプレフィックスを付けてリネームするか、Resolveの音声分離/文字起こし機能を使ってよりスマートにマッチングしてください
大規模プロジェクトでMCPツール実行中にResolveが重くなる — 小さな「アセンブリ」プロジェクトで作業し、後から本番プロジェクトにコンフォームしてください

組み合わせ： filesystem

タイムライン全体にカラープリセットを一括適用する

👤 アシスタント業務を行うカラリスト ⏱ ~15 min intermediate

使うタイミング： 手動グレーディングを始める前に、60クリップにベースLUTと彩度補正を適用したい場合に使います。

フロー

タイムラインの構成を確認

List every clip in the active timeline with in/out and source filename.✓ コピーしました

→ クリップ一覧
プリセットを適用

For every clip, apply Power Grade 'EP04_Base' as the first node.✓ コピーしました

→ サムネイルが更新される
異常なクリップにフラグを立てる

Which clips look significantly outside the normal range after the preset? Suggest per-clip adjustments.✓ コピーしました

→ 手動確認が必要なクリップの短いリスト

結果： 一貫したベースグレードが数秒で適用され、手動対応が必要な箇所にフラグが付きます。

1つのタイムラインから複数の納品ファイルを書き出す

👤 YouTube・Instagram・放送向けに納品するエディター ⏱ ~10 min beginner

使うタイミング： 同じ編集内容を3つの書き出し仕様で出力したいが、レンダーページを3回操作したくない場合に使います。

フロー

3つのレンダリングをキューに追加

Queue renders for active timeline: YouTube 1080p H.264 to ~/Exports/yt.mp4, Instagram 1080x1350 to ig.mp4, ProRes 422 HQ to broadcast.mov.✓ コピーしました

→ レンダーキューに3つのジョブが入る
開始して進捗を監視

Start all queued jobs and report when done.✓ コピーしました

→ ジョブごとの完了ステータス

結果： 1回のチャットで複数フォーマットの納品が完了します。

組み合わせ： filesystem

組み合わせ

他のMCPと組み合わせて10倍の力を

davinci-resolve + filesystem

ディスクからスクリプトやEDLを読み込み、それに合わせてカットを組む

Read ~/Project/EP04/edl.txt and build a matching timeline in the current Resolve project.✓ コピーしました

davinci-resolve + after-effects

After EffectsでVFXを仕上げてからResolveにコンフォームする

After AE renders are done at ~/renders/vfx/, replace the corresponding placeholder clips in Resolve's timeline with the new files.✓ コピーしました

ツール

このMCPが提供する機能

ツール	入力	呼び出すタイミング	コスト
resolve	action: str, params?: object	アプリレベル：ページ切替、レイアウト、レンダープリセット	free (local)
project_manager	action, params	プロジェクトの作成・開く・削除、データベース、クラウド	free
project	action, params	タイムライン、レンダーパイプライン、設定、LUT	free
media_pool	action, params	クリップとタイムラインのインポート・整理	free
timeline	action, params	トラック、マーカー、アイテム、ジェネレーター	free
timeline_item	action, params	クリップ単位のプロパティ、Fusionコンプ、バージョン、CDL	free
timeline_item_transform	item_id, pan?, tilt?, zoom?, rotation?	クリップの位置変更・リサイズ	free
timeline_item_keyframes	item_id, property, frame, value	キーフレーム対応プロパティのアニメーション設定	free
gallery	action, params	スチルとPower Grade	free
fusion_comp	action, params	Fusionノードグラフの構築・編集	free

コストと制限

運用コスト

APIクォータ: ネットワーク不要 — すべてローカルスクリプトAPIで完結します
呼び出しあたりのトークン: ほとんどのレスポンスは200〜800トークン。大規模編集のタイムラインダンプでは5kに達する場合があります
金額: DaVinci Resolve Studio 買い切り約$295（必須）。MCP自体は無料/MITライセンスです。
ヒント: コストはResolve Studioの購入費とレンダリング時間のみで、API呼び出しは無料です。プロジェクト全体のダンプではなく、スコープを絞ったリスト（1タイムライン、1トラック）をリクエストしてください。

セキュリティ

権限、シークレット、影響範囲

認証情報の保管： 認証情報不要 — ローカルスクリプトのみ

データ送信先： なし。すべてのAPI呼び出しはResolve内で完結します。

絶対に付与しない： Remote network exposure of the MCP — keep it local

「外部スクリプト使用」は必ず「Local」に設定してください。ネットワーク全体を自分で管理している場合を除き、「Network」は使用しないでください。
MCPはプロジェクトのフルコントロール権限を持ちます。本日納品予定のプロジェクトで実験しないでください。

トラブルシューティング

よくあるエラーと対処法

No connection to DaVinci Resolve — Resolveへの接続がありません

Resolveが起動中で「外部スクリプト使用：Local」が有効になっていることを確認してください。設定変更後はResolveを再起動してください。

確認： Preferences > System > General shows Local

Free edition: scripting disabled — 無料版ではスクリプトが無効です

無料版はスクリプトAPIを公開していません。Studio版にアップグレードしてください。

Python version mismatch on macOS — macOSでPythonバージョンが一致しません

インストーラーはPython 3.10〜3.12を推奨します。pyenv install 3.11.9を実行してからinstall.pyを再実行してください。

確認： python3 --version

Operations time out on a 4K project — 4Kプロジェクトで操作がタイムアウトします

ResolveのスクリプトAPIはシングルスレッドで、UI更新の後ろにキューイングされます。大規模バッチ操作中はResolveのビューアパネルを最小化してください。

代替案

davinci-resolve-mcp 他との比較

代替案	代わりに使う場面	トレードオフ
Adobe Premiere MCPs (community)	パイプラインがResolveではなくPremiereの場合	PremiereのMCPエコシステムはまだ成熟度が低い
After Effects MCP	編集やカラーではなくモーショングラフィックスが中心の場合	パイプラインの異なるステージ向け
Raw Python + Resolve API	AIが不要で完全な制御が必要な場合	MCPなし＝チャットインターフェースなし

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る