DaVinci Resolve MCP Server

DaVinci Resolve MCP Server

MCP クライアントがツールとリソースを通じて DaVinci Resolve（Fusion を含む）を操作および確認できる、Model Context Protocol（MCP）サーバーです。

提供機能

• プロジェクト管理（作成、読み込み、保存）
• タイムライン操作（タイムラインの作成、切り替え、クリップからの作成）
• メディアプール操作（メディアの読み込み、フォルダーの作成、フォルダーの確認）
• Fusion ヘルパー（クリップへのコンポジション追加、ノードの作成、ノードチェーンの作成）
• Resolve のページ移動
• 高度なスクリプト実行（execute_python、execute_lua）

要件

• Python 3.10+
• スクリプティング API が利用可能な DaVinci Resolve
• MCP 互換のクライアント（例：Claude Desktop）

インストール

git clone https://github.com/apvlv/davinci-resolve-mcp.git
cd davinci-resolve-mcp
uv sync --all-extras --dev

サーバーの起動

uv run davinci-resolve-mcp

サーバーは起動時に Resolve への接続を試みます。DaVinci Resolve が起動していることを確認してください。

MCP クライアントの設定

サーバーを起動するコマンドを MCP クライアントに設定します。

{
  "mcpServers": {
    "davinci-resolve": {
      "command": "uv",
      "args": ["run", "davinci-resolve-mcp"]
    }
  }
}

リソース

• system://status
• project://current
• project://timelines
• timeline://current
• mediapool://folders
• mediapool://current
• storage://volumes

ツール

プロジェクト

• create_project(name)
• load_project(name)
• save_project()

タイムライン

• create_timeline(name)
• set_current_timeline(index)

メディア

• import_media(file_paths)
• create_folder(name)
• create_timeline_from_clips(name, clip_indices)

Fusion

• add_fusion_comp_to_clip(timeline_index, track_type, track_index, item_index)
• create_fusion_node(node_type, parameters)
• create_fusion_node_chain(node_chain)

Resolve UI

• open_page(page_name)。ページ名には次のいずれかを指定します。
  • media、edit、fusion、color、fairlight、deliver

高度な機能

• execute_python(code)
• execute_lua(script)

開発

make install      # install deps and pre-commit hooks
make lint-check   # ruff check
make format-check # ruff format check
make test         # pytest with coverage
make check        # lint + format + tests

使用例

• 「My Documentary という名前のプロジェクトを作成する」
• 「現在のプロジェクトのタイムラインを一覧表示する」
• 「これらのファイルをメディアプールに読み込む」
• 「Color ページを開く」
• 「Blur -> ColorCorrector の Fusion ノードチェーンを作成する」

ライセンス

MIT（LICENSE を参照）