DaVinci Resolve MCP サーバー

ResolveAPIクラスの機能拡張を反映し、分かりやすさを向上させ、セットアップと使用方法に関する詳細情報を追加したREADMEの更新版をお届けします。構成は元のREADMEと同じですが、新機能（ギャラリー管理、トラックコントロール、オーディオ調整、再生など）を組み込み、 uvインストールとClaude統合の手順を改良しました。

DaVinci Resolve MCP サーバー

Claude のような AI アシスタントが DaVinci Resolve Studio と対話できるようにし、編集、カラーグレーディング、オーディオなどを高度に制御できる Model Context Protocol (MCP) サーバー。

概要

このサーバーは、AIアシスタントとDaVinci Resolve間のブリッジとなるMCPプロトコルを実装しています。これにより、AIアシスタントは以下のことが可能になります。

DaVinci Resolveプロジェクトの作成、読み込み、管理
タイムライン、トラック、クリップを操作する
メディアファイルのインポートと整理
Fusion コンポジションにアクセスして変更する
ギャラリーでカラーグレーディングや静止画の管理を行う
オーディオ設定を調整し、再生を制御する
Resolve ページ (メディア、編集、Fusion、カラー、Fairlight、Deliver) 間を移動します
カスタム Python および Lua スクリプトを実行する
プロジェクトのエクスポートとインポート

要件

DaVinci Resolve Studio 18.0以降
Python 3.10以降
DaVinci Resolve スクリプト API へのアクセス

UVによる設置

uvは、pip よりも優れたパフォーマンスを発揮する、高速で最新の Python パッケージインストーラー兼リゾルバーです。uv uv使用して DaVinci Resolve MCP サーバーをインストールおよびセットアップするには、以下の手順に従ってください。

1. uvをインストールする

uvがインストールされていない場合:

# Using pip (ensure pip is for Python 3.10+)
pip install uv

# Using Homebrew (macOS)
brew install uv

# Using Conda
conda install -c conda-forge uv

インストールを確認します:

uv --version

2. 仮想環境を作成する

依存関係を分離するために仮想環境を作成してアクティブ化します。

uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

3. DaVinci Resolve MCPサーバーをインストールする

プロジェクトディレクトリからサーバーとその依存関係をインストールします。

# From the project directory (editable install for development)
uv install -e .

# Or directly from GitHub (replace with your repo URL)
uv install git+https://github.com/yourusername/davinci-resolve-mcp.git

4. 依存関係をインストールする

requirements.txtに次の内容が含まれていることを確認します。

mcp
pydantic

インストールします:

uv install -r requirements.txt

構成

サーバーを実行する前に、次の点を確認してください。

DaVinci Resolve Studio が実行中です。
Python は DaVinci Resolve スクリプト API にアクセスできます (ほとんどの場合、 ResolveAPIによって自動的に処理されます)。

APIアクセス構成

ResolveAPIクラスはスクリプト API を動的に見つけますが、場合によっては手動で構成する必要があります。

macOS

API は通常、次の場所で利用できます。

/Library/Application Support/Blackmagic Design/DaVinci Resolve/Developer/Scripting/Modules
またはユーザー固有: ~/Library/Application Support/Blackmagic Design/DaVinci Resolve/Developer/Scripting/Modules

通常、追加の設定は必要ありません。

ウィンドウズ

検出されない場合は API パスを追加します。

import sys
sys.path.append("C:\\ProgramData\\Blackmagic Design\\DaVinci Resolve\\Support\\Developer\\Scripting\\Modules")

リナックス

環境変数を設定します。

export PYTHONPATH=$PYTHONPATH:/opt/resolve/Developer/Scripting/Modules

あるいは、環境変数を使用してカスタムパスを設定します。

export RESOLVE_SCRIPT_PATH="/custom/path/to/scripting/modules"

サーバーの実行

MCP サーバーを起動します。

# Run directly with Python
python -m resolve_mcp.server

# Or with uv
uv run resolve_mcp/server.py

サーバーが起動して DaVinci Resolve に接続し、次のような出力がログに記録されます。

2025-03-19 ... - resolve_mcp - INFO - Successfully connected to DaVinci Resolve.

クロード統合構成

Claude Desktop と統合するには、 claude_desktop_config.json (例: macOS では~/Library/Application Support/Claude/claude_desktop_config.json ) を更新します。

{
  "mcpServers": {
    "davinci-resolve": {
      "command": "/path/to/uv",
      "args": [
        "run",
        "--directory",
        "/path/to/davinci-resolve-mcp",
        "resolve_mcp/server.py"
      ]
    }
  }
}

/path/to/uv``uv実行可能ファイルへのパスに置き換えます (例: /usr/local/bin/uvまたはC:\Users\username\.cargo\bin\uv.exe )。
/path/to/davinci-resolve-mcpプロジェクトディレクトリへの絶対パスに置き換えます。

サーバーを有効にするには、Claude Desktopを再起動してください。入力ボックスにハンマーアイコンが表示されたら、統合が完了していることを確認してください。

トラブルシューティング

接続の問題

サーバーへの接続に失敗した場合:

DaVinci Resolve Studio が実行されていることを確認します。
Resolve の設定をチェックして、スクリプトが有効になっていることを確認します。
Python バージョンの互換性を確認します (3.10 以上を推奨)。
python --version
API パスにアクセスできることを確認します (macOS の場合は~/Library/Logs/Claude/mcp*.log 、Windows の場合は%userprofile%\AppData\Roaming\Claude\Logs\ログを参照してください)。

依存関係の問題

mcpやpydanticなどのモジュールが見つからない場合:

uv install mcp pydantic

Pythonバージョンの互換性

必要に応じて、 pyenvと互換性のあるバージョンに切り替えます。

pyenv install 3.10.12
pyenv shell 3.10.12
uv install -r requirements.txt

利用可能なツールとリソース

MCP サーバーは、 ResolveAPIクラスを通じて広範な機能を提供します。

プロジェクト管理

新しいプロジェクトを作成する ( create_project )
既存のプロジェクトをロードする ( load_project )
現在のプロジェクトを保存する ( save_project )
プロジェクトのエクスポート/インポート ( export_project 、 import_project )
プロジェクト設定の取得/設定 ( get_project_settings 、 set_project_setting )

タイムライン操作

新しいタイムラインを作成する ( create_timeline )
現在のタイムラインを設定/取得する ( set_current_timeline 、 get_current_timeline )
トラックの追加/管理 ( add_track 、 set_track_name 、 enable_track )
タイムラインアイテムを取得する ( get_timeline_items )
クリップのプロパティを設定する（ set_clip_property ）
マーカーを追加する ( add_timeline_marker )

メディア管理

メディアファイルをインポートする ( add_items_to_media_pool )
メディアプールフォルダを作成する（ add_sub_folder ）
クリップからタイムラインを作成する ( create_timeline_from_clips )
クリップのメタデータを取得する ( get_clip_metadata )

融合統合

クリップにFusionコンポジションを追加する（ create_fusion_node ）
Fusion ノードの作成/管理 ( create_fusion_node )
現在の構成にアクセスする ( get_current_comp )

カラーグレーディング

カラーノードを取得/追加する ( get_color_page_nodes 、 add_color_node )
静止画を保存/適用する ( save_still 、 apply_still )
ギャラリーアルバムを管理する ( get_gallery_albums )

オーディオコントロール

クリップのオーディオ音量を取得/設定する ( get_audio_volume 、 set_audio_volume )
トラックの音量を設定する ( set_track_volume )

再生コントロール

再生/停止（ play 、 stop ）
再生ヘッドの位置を取得/設定する ( get_current_timecode 、 set_playhead_position )

レンダリング

レンダリングを開始する ( start_render )
レンダリングステータスを取得する ( get_render_status )

高度な操作

カスタム Python コードを実行する ( execute_python )
Fusion で Lua スクリプトを実行する ( execute_lua )

発達

貢献するには:

リポジトリをフォークする: https://github.com/yourusername/davinci-resolve-mcp
機能ブランチを作成する: git checkout -b feature-name
依存関係をインストールします: uv install -e .
変更を加えてテストします: uv run resolve_mcp/server.py
プルリクエストを送信します。

ライセンス

MITライセンス

主な更新

拡張機能: ギャラリー管理、トラック制御、オーディオ調整、再生、プロジェクトのエクスポート/インポートなどの新しい機能が「利用可能なツールとリソース」セクションに追加されました。
インストールの明確化: 検証手順と Claude 統合の明示的なパスを含むuv手順が改善されました。
トラブルシューティング: デバッグ用の特定のコマンドとログの場所が強化されました。
構成: ResolveAPIでの動的パス処理を反映するように API アクセスノートを更新しました。

このREADMEは、拡張されたResolveAPIクラスと完全に連携し、ユーザーと開発者にとって包括的なガイドとなりました。さらに調整が必要な場合はお知らせください。

DaVinci Resolve MCP Server