DaVinci Resolve MCP Server Integration

A Model Context Protocol (MCP) server that connects AI coding assistants (Cursor, Claude Desktop) to DaVinci Resolve, enabling them to query and control DaVinci Resolve through natural language.

Features

• Connect to DaVinci Resolve: Query information and control DaVinci Resolve from your AI assistant.
• Project Management: List, open, and create DaVinci Resolve projects.
• Timeline Operations: Create timelines, switch between them, add markers.
• Media Management: Import media, create bins, list clips.
• Multi-Client Support: Works with both Cursor and Claude Desktop.
• Cross-Platform: Full support for both macOS and Windows.

Requirements

• macOS or Windows with DaVinci Resolve installed.
• Python 3.6+.
• DaVinci Resolve running in the background.
• (Optional) Node.js/npm for some features.

Platform Support

Quick Start Guide

All

1. Clone the repository:
   shell git clone https://github.com/samuelgursky/davinci-resolve-mcp.git cd davinci-resolve-mcp
2. Make sure DaVinci Resolve Studio is installed and running.

For Windows Users

• Double-click run-now.bat in the root of the repo or run it from Command Prompt:
  shell run-now.bat

For macOS Users

Make the script executable and run:

chmod +x run-now.sh
./run-now.sh

Configuration

For configuration of DaVinci Resolve MCP with different AI assistant clients like Cursor or Claude, see the config-templates directory.

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

For issues and feature requests, please use the GitHub issue tracker.

Launch Options

After installation, you have several ways to start the server:

Client-Specific Launch Scripts

The repository includes dedicated scripts for launching with specific clients:

# For Cursor integration (macOS)
chmod +x scripts/mcp_resolve-cursor_start
./scripts/mcp_resolve-cursor_start

# For Claude Desktop integration (macOS)
chmod +x scripts/mcp_resolve-claude_start
./scripts/mcp_resolve-claude_start

Pre-Launch Check

Before connecting AI assistants, verify your environment is properly configured:

# On macOS
./scripts/check-resolve-ready.sh

# On Windows
./scripts/check-resolve-ready.bat

Universal Launcher

For advanced users, our unified launcher provides full control over both Cursor and Claude Desktop servers:

# Make the script executable (macOS only)
chmod +x scripts/mcp_resolve_launcher.sh

# Run in interactive mode
./scripts/mcp_resolve_launcher.sh

# Or use command line options
./scripts/mcp_resolve_launcher.sh --start-cursor    # Start Cursor server
./scripts/mcp_resolve_launcher.sh --start-claude    # Start Claude Desktop server
./scripts/mcp_resolve_launcher.sh --start-both      # Start both servers
./scripts/mcp_resolve_launcher.sh --stop-all        # Stop all running servers
./scripts/mcp_resolve_launcher.sh --status          # Show server status

Full Installation

For a complete manual installation:

1. Clone this repository:
   shell git clone https://github.com/samuelgursky/davinci-resolve-mcp.git cd davinci-resolve-mcp
2. Create a Python virtual environment:
   shell python -m venv venv source venv/bin/activate # macOS/Linux venv\Scripts\activate # Windows pip install git+https://github.com/modelcontextprotocol/python-sdk.git

3. Set up DaVinci Resolve scripting environment variables.

4. Configure Cursor to use the server by creating a configuration file.

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:
   shell ./scripts/mcp_resolve-cursor_start
2. Start Cursor and open a project.
3. In Cursor's AI chat, you can now interact with DaVinci Resolve.

Using with Claude Desktop

1. Create a claude_desktop_config.json file in your Claude Desktop configuration directory.
2. Run the Claude Desktop server using the dedicated script:
   shell ./scripts/mcp_resolve-claude_start
3. In Claude Desktop, you can now interact with DaVinci Resolve.

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

Windows support is stable in v1.3.3 and should not require additional troubleshooting.

Troubleshooting

DaVinci Resolve Connection

Make sure DaVinci Resolve is running before starting the server.

Project Structure

davinci-resolve-mcp/
├── README.md                 # Main documentation
├── CHANGELOG.md              # Version history
├── FEATURES.md               # Feature matrix
├── LICENSE                   # License information
├── resolve_mcp_server.py     # Main server implementation
├── mcp_resolve_launcher.sh   # Symbolic link to the universal launcher
├── run-now.sh                # Symbolic link to the quick start script
├── run-now.bat               # Symbolic link to the Windows quick start script
├── src/                      # Source code modules
│   └── utils/                # Utility modules
│       ├── platform.py       # Platform-specific functionality
│       └── resolve_connection.py # Resolve connection utilities
├── config-templates/         # Configuration templates
│   ├── README.md             # Template documentation
│   ├── cursor-mcp-config.template.json # Cursor configuration template
│   └── claude-desktop-config.template.json # Claude Desktop configuration template
├── scripts/                  # Helper scripts
│   ├── README.md             # Script documentation
│   ├── run-now.sh            # Quick start script
│   ├── run-now.bat           # Quick start script (Windows)
│   ├── check-resolve-ready.bat # Pre-launch check (Windows)
│   ├── setup.sh              # Full installation
│   ├── server.sh             # Consolidated server management
│   ├── mcp_resolve_launcher.sh # Universal launcher script
│   ├── mcp_resolve-cursor_start # Cursor-specific launcher
│   ├── mcp_resolve-claude_start # Claude-specific launcher
│   └── check-resolve-ready.sh # Pre-launch check
├── examples/                 # Example usage scripts
│   ├── README.md             # Examples documentation
│   ├── getting_started.py    # Simple starter example
│   ├── markers/              # Marker-related examples
│   │   ├── README.md         # Marker examples documentation
│   │   └── ...               # Marker example scripts
│   ├── timeline/             # Timeline examples
│   │   ├── README.md         # Timeline examples documentation
│   │   └── ...               # Timeline example scripts
│   └── media/                # Media management examples
│       ├── README.md         # Media examples documentation
│       └── ...               # Media example scripts
└── venv/                     # Python virtual environment (created by setup script)

License

MIT

Acknowledgments

• Blackmagic Design for DaVinci Resolve and its API.
• The MCP protocol team for enabling AI assistant integration.

Author

Samuel Gursky ([email protected])
GitHub: github.com/samuelgursky

Future Plans

• Windows and Linux support.
• Additional DaVinci Resolve features.
• Support for Claude Desktop.

Development

If you'd like to contribute, please check the feature checklist in the repo and pick an unimplemented feature to work on. The code is structured with clear sections for different areas of functionality.

About

MCP server integration for DaVinci Resolve.

Topics

mcp
blackmagic
blackmagic-design
blackmagicdesign
davinci-resolve
davinciresolve
mcp-server

Resources

Readme

License

MIT license

Activity

Stars

34 stars

Watchers

2 watching

Forks

4 forks

Report repository

Releases

3 tags

Packages 0

Contributors 2

Languages

• Shell 48.4%
• Python 38.6%
• PowerShell 10.3%
• Batchfile 2.7%