DaVinci Resolve MCP Server

Features

Requirements

• macOS or Windows with DaVinci Resolve installed

• Python 3.6+

• DaVinci Resolve running in the background

• (Optional) Node.js/npm for some features

Installation Guide

• Prerequisites and system requirements

• Step-by-step installation process

• Configuration details

• Common troubleshooting steps

Platform Support

Quick Start Guide

New One-Step Installation (Recommended)

• Clone the repository:

• Make sure DaVinci Resolve Studio is installed and running

• Run the installation script: macOS/Linux: Windows:

1. Automatically detect the correct paths on your system

2. Create a Python virtual environment

3. Install the MCP SDK from the official repository

4. Set up environment variables

5. Configure Cursor/Claude integration

6. Verify the installation is correct

7. Optionally start the MCP server

Alternative Quick Start

Configuration

Troubleshooting

Common Issues

Path Resolution

• The installation scripts now use more robust path resolution, fixing issues with run-now.sh looking for files in the wrong locations

• Always let the scripts determine the correct paths based on their location

DaVinci Resolve Detection

• We've improved the process detection to reliably find DaVinci Resolve regardless of how it appears in the process list

• Make sure DaVinci Resolve is running before starting the MCP server

Environment Variables

• Make sure all required environment variables are set correctly

• Review the log file at scripts/cursor_resolve_server.log for troubleshooting

Windows

• Make sure to use forward slashes (/) in configuration files

• Python must be installed and paths configured in configs

• DaVinci Resolve must be running before starting the server

macOS

• Make sure scripts have execute permissions

• Check Console.app for any Python-related errors

• Verify environment variables are set correctly

• DaVinci Resolve must be running before starting the server

Support

Launch Options

Client-Specific Launch Scripts

• Set up the proper environment for each client

• Verify DaVinci Resolve is running

• Configure client-specific settings

• Start the MCP server with appropriate parameters

Pre-Launch Check

• Verify DaVinci Resolve is running (and offer to start it)

• Check environment variables are properly set

• Ensure the Python environment is configured correctly

• Validate Cursor/Claude configuration

• Optionally launch Cursor

Universal Launcher

• Force mode (skip Resolve running check): --force

• Project selection: --project "Project Name"

Full Installation

1. Clone this repository:

2. Create a Python virtual environment:

3. Set up DaVinci Resolve scripting environment variables:For macOS:For Windows:Alternatively, run the pre-launch check script which will set these for you:

4. Configure Cursor to use the server by creating a configuration file:For macOS (~/.cursor/mcp.json):For Windows (%APPDATA%\Cursor\mcp.json):

5. Start the server using one of the client-specific scripts:

Usage with AI Assistants

Using with Cursor

1. Start the Cursor server using the dedicated script:Or use the universal launcher:

2. Start Cursor and open a project.

3. In Cursor's AI chat, you can now interact with DaVinci Resolve. Try commands like:

Using with Claude Desktop

1. Create a claude_desktop_config.json file in your Claude Desktop configuration directory using the template in the config-templates directory.

2. Run the Claude Desktop server using the dedicated script:Or use the universal launcher:

3. In Claude Desktop, you can now interact with DaVinci Resolve using the same commands as with Cursor.

Available Features

General

• Get DaVinci Resolve version

• Get/switch current page (Edit, Color, Fusion, etc.)

Project Management

• List available projects

• Get current project name

• Open project by name

• Create new project

• Save current project

Timeline Operations

• List all timelines

• Get current timeline info

• Create new timeline

• Switch to timeline by name

• Add marker to timeline

Media Pool Operations

• List media pool clips

• Import media file

• Create media bin

• Add clip to timeline

Windows Support Notes

• Ensure DaVinci Resolve is installed in the default location

• Environment variables are properly set as described above

• Windows paths may require adjustment based on your installation

• For issues, please check the logs in the logs/ directory

Troubleshooting

DaVinci Resolve Connection

1. Your environment variables are set correctly

2. You have the correct paths for your DaVinci Resolve installation

3. You have restarted your terminal after setting environment variables

Project Structure

License

Acknowledgments

• Blackmagic Design for DaVinci Resolve and its API

• The MCP protocol team for enabling AI assistant integration

Author

• GitHub: github.com/samuelgursky

Future Plans

• Windows and Linux support

• Additional DaVinci Resolve features

• Support for Claude Desktop

Development

License

Acknowledgments

• Blackmagic Design for DaVinci Resolve and its API

• The MCP protocol team for enabling AI assistant integration

Project Structure

• resolve_mcp_server.py - The main MCP server implementation

• run-now.sh - Quick start script that handles setup and runs the server

• setup.sh - Complete setup script for installation

• check-resolve-ready.sh - Pre-launch check to verify DaVinci Resolve is ready

• start-server.sh - Script to start the server

• run-server.sh - Simplified script to run the server directly

• src/ - Source code and modules

• assets/ - Project assets and resources

• logs/ - Log files directory

• scripts/ - Helper scripts

Changelog

Cursor-Specific Setup

1. Make sure DaVinci Resolve is running before starting Cursor

2. Install required dependencies:Note: This will install the MCP package and other dependencies automatically.

3. Set up the MCP server configuration in Cursor:Create or edit ~/.cursor/mcp.json on macOS (or %USERPROFILE%\.cursor\mcp.json on Windows):Important Notes:

4. Common issues:

DaVinci Resolve MCP Server

Features

Requirements

• macOS or Windows with DaVinci Resolve installed

• Python 3.6+

• DaVinci Resolve running in the background

• (Optional) Node.js/npm for some features

Installation Guide

• Prerequisites and system requirements

• Step-by-step installation process

• Configuration details

• Common troubleshooting steps

Platform Support

Quick Start Guide

New One-Step Installation (Recommended)

• Clone the repository:

• Make sure DaVinci Resolve Studio is installed and running

• Run the installation script: macOS/Linux: Windows:

1. Automatically detect the correct paths on your system

2. Create a Python virtual environment

3. Install the MCP SDK from the official repository

4. Set up environment variables

5. Configure Cursor/Claude integration

6. Verify the installation is correct

7. Optionally start the MCP server

Alternative Quick Start

Configuration

Troubleshooting

Common Issues

Path Resolution

• The installation scripts now use more robust path resolution, fixing issues with run-now.sh looking for files in the wrong locations

• Always let the scripts determine the correct paths based on their location

DaVinci Resolve Detection

• We've improved the process detection to reliably find DaVinci Resolve regardless of how it appears in the process list

• Make sure DaVinci Resolve is running before starting the MCP server

Environment Variables

• Make sure all required environment variables are set correctly

• Review the log file at scripts/cursor_resolve_server.log for troubleshooting

Windows

• Make sure to use forward slashes (/) in configuration files

• Python must be installed and paths configured in configs

• DaVinci Resolve must be running before starting the server

macOS

• Make sure scripts have execute permissions

• Check Console.app for any Python-related errors

• Verify environment variables are set correctly

• DaVinci Resolve must be running before starting the server

Support

Launch Options

Client-Specific Launch Scripts

• Set up the proper environment for each client

• Verify DaVinci Resolve is running

• Configure client-specific settings

• Start the MCP server with appropriate parameters

Pre-Launch Check

• Verify DaVinci Resolve is running (and offer to start it)

• Check environment variables are properly set

• Ensure the Python environment is configured correctly

• Validate Cursor/Claude configuration

• Optionally launch Cursor

Universal Launcher

• Force mode (skip Resolve running check): --force

• Project selection: --project "Project Name"

Full Installation

1. Clone this repository:

2. Create a Python virtual environment:

3. Set up DaVinci Resolve scripting environment variables:For macOS:For Windows:Alternatively, run the pre-launch check script which will set these for you:

4. Configure Cursor to use the server by creating a configuration file:For macOS (~/.cursor/mcp.json):For Windows (%APPDATA%\Cursor\mcp.json):

5. Start the server using one of the client-specific scripts:

Usage with AI Assistants

Using with Cursor

1. Start the Cursor server using the dedicated script:Or use the universal launcher:

2. Start Cursor and open a project.

3. In Cursor's AI chat, you can now interact with DaVinci Resolve. Try commands like:

Using with Claude Desktop

1. Create a claude_desktop_config.json file in your Claude Desktop configuration directory using the template in the config-templates directory.

2. Run the Claude Desktop server using the dedicated script:Or use the universal launcher:

3. In Claude Desktop, you can now interact with DaVinci Resolve using the same commands as with Cursor.

Available Features

General

• Get DaVinci Resolve version

• Get/switch current page (Edit, Color, Fusion, etc.)

Project Management

• List available projects

• Get current project name

• Open project by name

• Create new project

• Save current project

Timeline Operations

• List all timelines

• Get current timeline info

• Create new timeline

• Switch to timeline by name

• Add marker to timeline

Media Pool Operations

• List media pool clips

• Import media file

• Create media bin

• Add clip to timeline

Windows Support Notes

• Ensure DaVinci Resolve is installed in the default location

• Environment variables are properly set as described above

• Windows paths may require adjustment based on your installation

• For issues, please check the logs in the logs/ directory

Troubleshooting

DaVinci Resolve Connection

1. Your environment variables are set correctly

2. You have the correct paths for your DaVinci Resolve installation

3. You have restarted your terminal after setting environment variables

Project Structure

License

Acknowledgments

• Blackmagic Design for DaVinci Resolve and its API

• The MCP protocol team for enabling AI assistant integration

Author

• GitHub: github.com/samuelgursky

Future Plans

• Windows and Linux support

• Additional DaVinci Resolve features

• Support for Claude Desktop

Development

License

Acknowledgments

• Blackmagic Design for DaVinci Resolve and its API

• The MCP protocol team for enabling AI assistant integration

Project Structure

• resolve_mcp_server.py - The main MCP server implementation

• run-now.sh - Quick start script that handles setup and runs the server

• setup.sh - Complete setup script for installation

• check-resolve-ready.sh - Pre-launch check to verify DaVinci Resolve is ready

• start-server.sh - Script to start the server

• run-server.sh - Simplified script to run the server directly

• src/ - Source code and modules

• assets/ - Project assets and resources

• logs/ - Log files directory

• scripts/ - Helper scripts

Changelog

Cursor-Specific Setup

1. Make sure DaVinci Resolve is running before starting Cursor

2. Install required dependencies:Note: This will install the MCP package and other dependencies automatically.

3. Set up the MCP server configuration in Cursor:Create or edit ~/.cursor/mcp.json on macOS (or %USERPROFILE%\.cursor\mcp.json on Windows):Important Notes:

4. Common issues: