resolve-mcp

DaVinci Resolve MCP — インデックス

Resolve MCP タスク全般の案内です。これは概要マップであり、詳細ではありません。以下の各ドメインスキルには、それぞれ固有のルーティングと、独自の description に基づくトリガーが用意されています。該当するものを開くか、複数のドメインにまたがるタスクではこのインデックスを使用してください。このスキルはほかのスキルを自動で読み込みません。各スキルへの案内を行います。

2 つのサーバー — オフラインで計算し、ライブで適用

• ライブ — davinci-resolve（Python）：スクリプティング API を介して、起動中の Resolve を操作します。
• 高度な操作／オフライン — davinci-resolve-advanced（Node）：Resolve を起動せずに、.drp／.drt／.drx ファイルを作成し、プロジェクト DB にパッチを適用します。

目安：グレーディング、QC、コンフォーム計算はオフラインで行い、結果をライブで適用します。Node から Resolve を操作することはありません。

ドメイン

タスク	スキル	カーネル	任意の MCP クライアント向けプロンプト
グレーディング、ルック、ショットマッチ、LUT／CDL／DRX	resolve-color	color-grade-kernel.md	/color_grade_workflow
カット、トリミング、範囲、バリエーション、変更リスト	resolve-edit	timeline-edit-kernel.md	/timeline_edit_workflow
コンフォーム、再リンク、仕上げ QC、グレード追跡	resolve-conform	timeline-conform-interchange-kernel.md	/conform_workflow
レンダリング、納品物 QC、メディア／来歴	resolve-delivery	render-deliver-kernel.md	/delivery_workflow
Fusion コンポジション（タイトル、MG、VFX）	resolve-fusion	fusion-composition-kernel.md	/fusion_workflow
オーディオ／Fairlight（トラック、バス、ラウドネス）	resolve-audio	audio-fairlight-kernel.md	/audio_workflow
メディアプールへの取り込み／整理／マルチカム	resolve-media-pool	media-pool-ingest-kernel.md	/media_pool_workflow
ソースメディアの読み取り／分析	resolve-media-analysis	media-analysis-guide.md	/analyze_media

あまり一般的でないドメイン（専用スキルなし — カーネル／ツールを直接使用）

これらの機能もサポートされていますが、利用頻度が比較的低いため、専用スキルではなく、このインデックスを経由します。

• プロジェクトのライフサイクル — プロジェクト、データベース、設定、プリセットの作成／エクスポート／インポート／アーカイブ／復元：複合ツール project_manager → docs/kernels/project-lifecycle-kernel.md。オフラインでの DB 読み取り／パッチ適用：高度な操作の project_read／project_db（プロジェクトを閉じ、終了してから再起動してください）。
• レビュー／注釈 — タイムラインマーカー、レビューレポート、注釈のコピー／移動／範囲設定：timeline_markers → docs/kernels/review-annotation-kernel.md。 オフラインでの監査／系譜：高度な操作の provenance。
• 拡張機能の作成 — Fuse／DCTL／Lua-Python プラグインのインストール／削除： script_plugin → docs/kernels/extension-authoring-kernel.md、 docs/authoring/。
• パイプライン（DB を真実の情報源として使用） — YAML で作成した正規プロジェクト DB、ゲート＋来歴＋差分検出を伴う段階的な実行：高度な操作の pipeline ツール → resolve-advanced/README.md。

機能を約束する前にビルドを確認する

スクリプト API はメジャーリリースごとではなく、PATCH リリースごとに変わります。 「Resolve 21」だけでは判断するには不十分です。GetFairlightPresets は 20.2.2 にはありますが 19.1.3 にはなく、21.0.4 で報告された 3 つのサーフェスは 21.0.2 にはありません。ビルドを把握せずに案内すると、存在しないメソッドがあるとエージェントが主張してしまいます（issue #132）。

そのため、可能なことを説明する前に、次の手順を実行してください。

1. resolve_control get_version → version_string（Resolve のビルド）と mcp.version（このサーバー）の両方を確認します。
2. resolve_control check_version_support → このビルドでは満たされない、記録済みのすべてのゲートを確認します。symbol を指定すると、1 つのメソッドについて回答します。
3. resolve_control api_truth "<topic>" → 各事実に version_context が含まれるようになり、古いビルド、新しいビルド、または同一ビルドのどれで測定されたかがわかります。古い測定結果は事前情報であり、確定した事実ではありません。

どちらも自ら知らせてくれるわけではないため、注意すべき失敗パターンを 2 つ挙げます。

• 一般的な回答は unknown です。これは「はい」ではなく、プローブを実行するという意味です。 記録済みの証拠があるサーフェスだけがゲートの対象です。API の大半は、バージョンごとの二分探索が一度も行われていません。利用不可の一覧にないからといって、メソッドが存在する保証にはなりません。
• mcp.version は、このプロセスの起動時のバージョンです。 実行中のサーバーはそのバージョンで動き続けるため、再起動するまで git pull しても台帳は更新されません。api_truth で見つからない場合、「既知の問題がない」のではなく、「サーバーが古い」可能性があります。

要求された機能に対してビルドが古すぎる場合は、その旨と必要な最低バージョンを伝えてください。呼び出しを提案して失敗させてはいけません。

全体に適用するルール（常時）

• ソースメディアは変更厳禁です（AGENTS.md）。明示的に依頼されていない限り、ソースメディアの変更、トランスコード、変換、プロキシ化、再リンク、派生物の作成は行わないでください。出力先にはサイドカー、スクラッチ領域、または分析プロジェクトのルートを使用します。
• カラー処理はフレームを最優先します。グレーディング／ルック／LUT／CDL／DRX を適用する前に、Resolve でレンダリングしたフレームを確認し、復元可能なグレードバージョンを保持してください。
• 高度なサーバーのガードは捏造せず、拒否します。再試行する前に「refused」メッセージを確認してください（通常は、値の空間が不適切、フレームがログエンコード済み、メディアが見つからない、またはオプションの依存関係が欠落しています。高度な capabilities ツールを呼び出してください）。

詳細なリファレンス

• AGENTS.md — 正式な概要と ## Domain Routing インデックス（全プラットフォーム）。
• docs/SKILL.md — 両方のサーバーの運用リファレンス。
• docs/kernels/ — アクションごとの詳細。resolve-advanced/README.md — オフラインカタログ。