DaVinci Resolve MCP サーバー

AI コーディング アシスタント (Cursor、Claude Desktop) を DaVinci Resolve に接続し、自然言語で DaVinci Resolve をクエリおよび制御できるようにする Model Context Protocol (MCP) サーバー。

特徴

実装済みおよび計画中の機能の包括的なリストについては、 docs/FEATURES.mdを参照してください。

要件

• DaVinci ResolveがインストールされたmacOSまたはWindows
• Python 3.6以上
• DaVinci Resolve がバックグラウンドで実行されている
• (オプション) 一部の機能については Node.js/npm

インストールガイド

詳細なインストール手順については、 INSTALL.md をご覧ください。このガイドでは以下の内容を取り上げます。

• 前提条件とシステム要件
• ステップバイステップのインストールプロセス
• 構成の詳細
• 一般的なトラブルシューティング手順

プラットフォームサポート

クイックスタートガイド

新しいワンステップインストール（推奨）

最も簡単な方法は、新しい統合インストールスクリプトを使用することです。このスクリプトはすべてを自動的に実行します。

• リポジトリをクローンします。
  git clone https://github.com/samuelgursky/davinci-resolve-mcp.git cd davinci-resolve-mcp
• DaVinci Resolve Studioがインストールされ、実行されていることを確認してください
• インストール スクリプトを実行します: macOS/Linux:
  ./install.sh
  ウィンドウズ:
  install.bat

これにより、次のようになります。

1. システム上の正しいパスを自動的に検出します
2. Python仮想環境を作成する
3. 公式リポジトリからMCP SDKをインストールする
4. 環境変数を設定する
5. カーソル/クロード統合の設定
6. インストールが正しいことを確認する
7. オプションでMCPサーバーを起動する

代替クイックスタート

オリジナルのクイック スタート スクリプトを使用することもできます。

Windows ユーザー:

macOS ユーザー:

構成

Cursor や Claude などのさまざまな AI アシスタント クライアントを使用した DaVinci Resolve MCP の構成については、 config-templatesディレクトリを参照してください。

トラブルシューティング

詳細なトラブルシューティング ガイダンスについては、一般的な問題の解決策が記載されているINSTALL.mdファイルを参照してください。

よくある問題

パス解決

• インストール スクリプトはより堅牢なパス解決を使用するようになり、 run-now.shが間違った場所にあるファイルを検索する問題が修正されました。
• 常にスクリプトがその場所に基づいて正しいパスを決定するようにします

DaVinci Resolve 検出

• プロセスリストに表示されているかどうかに関係なく、DaVinci Resolveを確実に見つけられるようにプロセス検出を改善しました。
• MCPサーバーを起動する前にDaVinci Resolveが起動していることを確認してください

環境変数

• 必要な環境変数がすべて正しく設定されていることを確認してください
• トラブルシューティングについては、 scripts/cursor_resolve_server.logのログファイルを確認してください。

ウィンドウズ

• 設定ファイルでは必ずスラッシュ（/）を使用してください
• Pythonがインストールされ、configsでパスが設定されている必要があります
• サーバーを起動する前にDaVinci Resolveが起動している必要があります

macOS

• スクリプトに実行権限があることを確認する
• Console.app で Python 関連のエラーがないか確認します
• 環境変数が正しく設定されていることを確認する
• サーバーを起動する前にDaVinci Resolveが起動している必要があります

サポート

問題や機能のリクエストについては、GitHub の問題追跡ツールを使用してください。

起動オプション

インストール後、サーバーを起動する方法はいくつかあります。

クライアント固有の起動スクリプト

リポジトリには、特定のクライアントで起動するための専用スクリプトが含まれています。

これらの特殊なスクリプト:

• 各クライアントに適切な環境を設定する
• DaVinci Resolveが動作していることを確認する
• クライアント固有の設定を構成する
• 適切なパラメータでMCPサーバーを起動します

発売前チェック

AI アシスタントを接続する前に、環境が適切に構成されていることを確認してください。

これらのスクリプトは次のことを行います。

• DaVinci Resolve が実行中であることを確認します（起動を提案します）。
• 環境変数が正しく設定されているか確認する
• Python環境が正しく設定されていることを確認する
• カーソル/クロード構成の検証
• オプションでカーソルを起動

ユニバーサルランチャー

上級ユーザー向けには、統合ランチャーにより、Cursor サーバーと Claude Desktop サーバーの両方を完全に制御できます。

追加オプション:

• 強制モード（Resolve 実行チェックをスキップ）: --force
• プロジェクトの選択: --project "Project Name"

完全インストール

完全な手動インストールの場合:

1. このリポジトリをクローンします:
   git clone https://github.com/samuelgursky/davinci-resolve-mcp.git cd davinci-resolve-mcp
2. Python 仮想環境を作成します。
   # Create virtual environment python -m venv venv # Activate it # On macOS/Linux: source venv/bin/activate # On Windows: venv\Scripts\activate # Install dependencies from requirements.txt pip install -r requirements.txt # Alternatively, install MCP SDK directly pip install git+https://github.com/modelcontextprotocol/python-sdk.git
3. DaVinci Resolve スクリプト環境変数を設定します。macOSの場合:
   export RESOLVE_SCRIPT_API="/Library/Application Support/Blackmagic Design/DaVinci Resolve/Developer/Scripting" export RESOLVE_SCRIPT_LIB="/Applications/DaVinci Resolve/DaVinci Resolve.app/Contents/Libraries/Fusion/fusionscript.so" export PYTHONPATH="$PYTHONPATH:$RESOLVE_SCRIPT_API/Modules/"
   Windowsの場合:
   set RESOLVE_SCRIPT_API=C:\ProgramData\Blackmagic Design\DaVinci Resolve\Support\Developer\Scripting set RESOLVE_SCRIPT_LIB=C:\Program Files\Blackmagic Design\DaVinci Resolve\fusionscript.dll set PYTHONPATH=%PYTHONPATH%;%RESOLVE_SCRIPT_API%\Modules
   あるいは、起動前チェック スクリプトを実行して、次の設定を自動的に行います。
   # On macOS ./scripts/check-resolve-ready.sh # On Windows ./scripts/check-resolve-ready.bat
4. 構成ファイルを作成して、Cursor がサーバーを使用するように設定します。macOS の場合( ~/.cursor/mcp.json ):
   { "mcpServers": { "davinci-resolve": { "name": "DaVinci Resolve MCP", "command": "/path/to/your/venv/bin/python", "args": [ "/path/to/your/davinci-resolve-mcp/src/main.py" ] } } }
   Windows の場合( %APPDATA%\Cursor\mcp.json ):
   { "mcpServers": { "davinci-resolve": { "name": "DaVinci Resolve MCP", "command": "C:\\path\\to\\venv\\Scripts\\python.exe", "args": ["C:\\path\\to\\davinci-resolve-mcp\\src\\main.py"] } } }
5. クライアント固有のスクリプトのいずれかを使用してサーバーを起動します。
   # For Cursor ./scripts/mcp_resolve-cursor_start # For Claude Desktop ./scripts/mcp_resolve-claude_start

AIアシスタントとの使用

カーソルの使用

1. 専用スクリプトを使用してカーソル サーバーを起動します。
   ./scripts/mcp_resolve-cursor_start
   または、ユニバーサル ランチャーを使用します。
   ./scripts/mcp_resolve_launcher.sh --start-cursor
2. カーソルを起動してプロジェクトを開きます。
3. カーソルのAIチャットで、DaVinci Resolveと対話できるようになりました。以下のコマンドをお試しください。
   • 「DaVinci Resolve のどのバージョンが実行されていますか？」
   • 「DaVinci Resolve内のすべてのプロジェクトを一覧表示する」
   • 「『マイシーケンス』という新しいタイムラインを作成します」
   • 「現在の位置にマーカーを追加する」

Claude Desktopでの使用

1. config-templatesディレクトリのテンプレートを使用して、Claude Desktop 構成ディレクトリにclaude_desktop_config.jsonファイルを作成します。
2. 専用スクリプトを使用して Claude デスクトップ サーバーを実行します。
   ./scripts/mcp_resolve-claude_start
   または、ユニバーサル ランチャーを使用します。
   ./scripts/mcp_resolve_launcher.sh --start-claude
3. Claude Desktop では、カーソルと同じコマンドを使用して DaVinci Resolve を操作できるようになりました。

利用可能な機能

一般的な

• DaVinci Resolveバージョンを入手する
• 現在のページを取得/切り替えます (編集、カラー、融合など)

プロジェクト管理

• 利用可能なプロジェクトの一覧
• 現在のプロジェクト名を取得する
• 名前でプロジェクトを開く
• 新しいプロジェクトを作成する
• 現在のプロジェクトを保存

タイムライン操作

• すべてのタイムラインを一覧表示する
• 現在のタイムライン情報を取得する
• 新しいタイムラインを作成する
• 名前でタイムラインに切り替える
• タイムラインにマーカーを追加する

メディアプール運用

• メディアプールのクリップを一覧表示する
• メディアファイルをインポート
• メディアビンを作成
• タイムラインにクリップを追加する

Windows サポートノート

Windows サポートは v1.3.3 で安定しており、追加のトラブルシューティングは必要ありません。

• DaVinci Resolveがデフォルトの場所にインストールされていることを確認する
• 環境変数は上記のように適切に設定されている
• Windowsのパスはインストールに応じて調整が必要な場合があります
• 問題が発生した場合は、 logs/ディレクトリのログを確認してください。

トラブルシューティング

DaVinci Resolve 接続

サーバーを起動する前に、DaVinci Resolve が起動していることを確認してください。サーバーが Resolve に接続できない場合は、以下の点を確認してください。

1. 環境変数が正しく設定されている
2. DaVinci Resolveのインストールパスが正しい
3. 環境変数を設定した後、ターミナルを再起動しました

プロジェクト構造

ライセンス

マサチューセッツ工科大学

謝辞

• DaVinci ResolveとそのAPIのためのBlackmagic Design
• AIアシスタントの統合を可能にするMCPプロトコルチーム

著者

サミュエル・ガースキー ( samgursky@gmail.com )

• GitHub: github.com/samuelgursky

今後の計画

• WindowsとLinuxのサポート
• DaVinci Resolveの追加機能
• Claudeデスクトップのサポート

発達

貢献したい場合は、リポジトリの機能チェックリストを確認し、未実装の機能を選んで作業を進めてください。コードは、機能領域ごとに明確なセクションに分かれて構成されています。

ライセンス

マサチューセッツ工科大学

謝辞

• DaVinci ResolveとそのAPIのためのBlackmagic Design
• AIアシスタントの統合を可能にするMCPプロトコルチーム

プロジェクト構造

クリーンアップ後、プロジェクトの構造は次のようになります。

• resolve_mcp_server.py - メインのMCPサーバーの実装
• run-now.sh - セットアップを処理してサーバーを実行するクイックスタートスクリプト
• setup.sh - インストール用の完全なセットアップ スクリプト
• check-resolve-ready.sh - DaVinci Resolve の準備ができているかどうかを確認するための起動前チェック
• start-server.sh - サーバーを起動するスクリプト
• run-server.sh - サーバーを直接実行するための簡略化されたスクリプト

主要ディレクトリ:

• src/ - ソースコードとモジュール
• assets/ - プロジェクト資産とリソース
• logs/ - ログファイルディレクトリ
• scripts/ - ヘルパースクリプト

開発時には、環境を設定してサーバーを 1 ステップで起動する./run-now.shを使用することをお勧めします。

変更履歴

詳細な変更履歴については、 docs/CHANGELOG.md を参照してください。

カーソル固有の設定

Cursor と統合する場合は、次の特定の手順に従ってください。

1. カーソルを起動する前にDaVinci Resolveが起動していることを確認してください
2. 必要な依存関係をインストールします。
   # From the davinci-resolve-mcp directory: pip install -r requirements.txt
   注: これにより、MCP パッケージとその他の依存関係が自動的にインストールされます。
3. Cursor で MCP サーバー構成を設定します。macOS では~/.cursor/mcp.json (Windows では%USERPROFILE%\.cursor\mcp.json ) を作成または編集します。
   { "mcpServers": { "davinci-resolve": { "name": "DaVinci Resolve MCP", "command": "/path/to/your/venv/bin/python", "args": [ "/path/to/your/davinci-resolve-mcp/src/main.py" ] } } }
   重要な注意事項:
   • エントリポイントとしてmain.pyを使用します（ resolve_mcp_server.pyではありません）。
   • 設定では絶対パスを使用する
4. よくある問題:
   • 「クライアントが閉じられました」エラー: mcp.json のパスが正しいことと、依存関係がインストールされていることを確認してください
   • 接続の問題: カーソルを起動する前に、DaVinci Resolve が起動していることを確認してください。
   • 環境変数: main.pyスクリプトは環境変数の設定を処理します