DaVinci Resolve MCP

by samuelgursky
Verified
# Project-Specific DaVinci Resolve Integration with Cursor This guide explains how to set up project-specific DaVinci Resolve integration with Cursor using MCP. ## Overview Project-specific integration allows Cursor to interact with a specific DaVinci Resolve project automatically. When you open a Cursor project, it can automatically connect to a matching DaVinci Resolve project. ## Setup Steps ### 1. Copy the Template Create a new file called `mcp.json` in your Cursor project's root directory (not in the `.cursor` folder). Copy the contents from `mcp-project-template.json`: ```json { "mcpServers": { "davinci-resolve": { "name": "DaVinci Resolve Project-Specific", "command": "${PROJECT_ROOT}/mcp_resolve-cursor_start", "args": ["--project", "${PROJECT_NAME}"] } } } ``` ### 2. Copy the Script Copy the `mcp_resolve-cursor_start` script to your project root: ```bash cp /path/to/davinci-resolve-mcp-20250326/mcp_resolve-cursor_start /path/to/your/project/ ``` Also copy the `run-direct-server.sh` and `direct_resolve_server.py` files: ```bash cp /path/to/davinci-resolve-mcp-20250326/run-direct-server.sh /path/to/your/project/ cp /path/to/davinci-resolve-mcp-20250326/direct_resolve_server.py /path/to/your/project/ ``` Make them executable: ```bash chmod +x /path/to/your/project/mcp_resolve-cursor_start chmod +x /path/to/your/project/run-direct-server.sh chmod +x /path/to/your/project/direct_resolve_server.py ``` ### 3. Create a Python Virtual Environment ```bash cd /path/to/your/project/ python -m venv venv source venv/bin/activate pip install jsonrpcserver ``` ### 4. Modify Variable Replacement By default, Cursor will replace: - `${PROJECT_ROOT}` with the absolute path to your project - `${PROJECT_NAME}` with the name of your project folder If your DaVinci Resolve project has a different name than your Cursor project folder, you'll need to manually edit the `mcp.json` file in your project to specify the correct project name: ```json { "mcpServers": { "davinci-resolve": { "name": "DaVinci Resolve Project-Specific", "command": "${PROJECT_ROOT}/mcp_resolve-cursor_start", "args": ["--project", "Your DaVinci Resolve Project Name"] } } } ``` ## Troubleshooting 1. **Make sure DaVinci Resolve is running** before you start Cursor or open your project. 2. **Check the log files** for errors: - `cursor_resolve_server.log` - Created by the startup script - `resolve_direct_server.log` - Created by the direct server 3. **Verify project exists** - Make sure the project name specified in your `mcp.json` exists in DaVinci Resolve. 4. **Permission issues** - Ensure all scripts are executable and have the right permissions. 5. **Test manually** by running: ```bash cd /path/to/your/project/ ./mcp_resolve-cursor_start --project "Your Project Name" ``` ## Advanced Configuration If you need additional arguments or setup for your project integration, you can modify: 1. The `mcp.json` file in your project to add more arguments 2. The `mcp_resolve-cursor_start` script to include custom setup steps ## Support For further assistance, please refer to the main documentation or reach out to the development team.