Servidor MCP de DaVinci Resolve

Un servidor de Protocolo de Contexto de Modelo (MCP) que conecta a los asistentes de codificación de IA (Cursor, Claude Desktop) con DaVinci Resolve, lo que les permite consultar y controlar DaVinci Resolve a través del lenguaje natural.

Características

Para obtener una lista completa de las características implementadas y planificadas, consulte docs/FEATURES.md .

Requisitos

• macOS o Windows con DaVinci Resolve instalado
• Python 3.6+
• DaVinci Resolve ejecutándose en segundo plano
• (Opcional) Node.js/npm para algunas funciones

Guía de instalación

Para obtener instrucciones de instalación detalladas, consulte INSTALL.md . Esta guía abarca:

• Prerrequisitos y requisitos del sistema
• Proceso de instalación paso a paso
• Detalles de configuración
• Pasos comunes para la solución de problemas

Soporte de plataforma

Guía de inicio rápido

Nueva instalación en un solo paso (recomendada)

La forma más sencilla de empezar es con nuestro nuevo script de instalación unificado. Este script lo hace todo automáticamente:

• Clonar el repositorio:
  git clone https://github.com/samuelgursky/davinci-resolve-mcp.git cd davinci-resolve-mcp
• Asegúrese de que DaVinci Resolve Studio esté instalado y ejecutándose
• Ejecute el script de instalación: macOS/Linux:
  ./install.sh
  Ventanas:
  install.bat

Esto hará lo siguiente:

1. Detecta automáticamente las rutas correctas en tu sistema
2. Crear un entorno virtual de Python
3. Instale el SDK de MCP desde el repositorio oficial
4. Configurar variables de entorno
5. Configurar la integración de Cursor/Claude
6. Verifique que la instalación sea correcta
7. Opcionalmente, inicie el servidor MCP

Inicio rápido alternativo

También puedes utilizar los scripts de inicio rápido originales:

Usuarios de Windows:

Usuarios de macOS:

Configuración

Para configurar DaVinci Resolve MCP con diferentes clientes asistentes de IA como Cursor o Claude, consulte el directorio config-templates .

Solución de problemas

Para obtener una guía detallada sobre solución de problemas, consulte el archivo INSTALL.md que contiene soluciones a problemas comunes.

Problemas comunes

Resolución de ruta

• Los scripts de instalación ahora utilizan una resolución de ruta más robusta, lo que soluciona los problemas con run-now.sh que busca archivos en ubicaciones incorrectas.
• Deje siempre que los scripts determinen las rutas correctas en función de su ubicación

Detección con DaVinci Resolve

• Hemos mejorado la detección de procesos para encontrar DaVinci Resolve de manera confiable independientemente de cómo aparezca en la lista de procesos.
• Asegúrese de que DaVinci Resolve se esté ejecutando antes de iniciar el servidor MCP

Variables de entorno

• Asegúrese de que todas las variables de entorno necesarias estén configuradas correctamente
• Revise el archivo de registro en scripts/cursor_resolve_server.log para solucionar problemas

Ventanas

• Asegúrese de utilizar barras diagonales (/) en los archivos de configuración
• Se debe instalar Python y configurar las rutas en configs.
• DaVinci Resolve debe estar ejecutándose antes de iniciar el servidor

macOS

• Asegúrese de que los scripts tengan permisos de ejecución
• Compruebe Console.app para detectar cualquier error relacionado con Python
• Verificar que las variables de entorno estén configuradas correctamente
• DaVinci Resolve debe estar ejecutándose antes de iniciar el servidor

Apoyo

Para problemas y solicitudes de funciones, utilice el rastreador de problemas de GitHub.

Opciones de lanzamiento

Después de la instalación, tienes varias formas de iniciar el servidor:

Scripts de lanzamiento específicos del cliente

El repositorio incluye scripts dedicados para el lanzamiento con clientes específicos:

Estos scripts especializados:

• Configurar el entorno adecuado para cada cliente
• Verifique que DaVinci Resolve se esté ejecutando
• Configurar ajustes específicos del cliente
• Inicie el servidor MCP con los parámetros adecuados

Comprobación previa al lanzamiento

Antes de conectar los asistentes de IA, verifique que su entorno esté configurado correctamente:

Estos scripts harán lo siguiente:

• Verifique que DaVinci Resolve se esté ejecutando (y ofrezca iniciarlo)
• Compruebe que las variables de entorno estén configuradas correctamente
• Asegúrese de que el entorno de Python esté configurado correctamente
• Validar la configuración de Cursor/Claude
• Opcionalmente, inicie Cursor

Lanzador universal

Para usuarios avanzados, nuestro iniciador unificado proporciona control total sobre los servidores Cursor y Claude Desktop:

Opciones adicionales:

• Modo de fuerza (omitir la comprobación de ejecución de Resolver): --force
• Selección de proyecto: --project "Project Name"

Instalación completa

Para una instalación manual completa:

1. Clonar este repositorio:
   git clone https://github.com/samuelgursky/davinci-resolve-mcp.git cd davinci-resolve-mcp
2. Crear un entorno virtual de 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. Configurar las variables de entorno de scripting de DaVinci Resolve:Para 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/"
   Para 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
   Como alternativa, ejecute el script de verificación previa al lanzamiento que configurará esto por usted:
   # On macOS ./scripts/check-resolve-ready.sh # On Windows ./scripts/check-resolve-ready.bat
4. Configure Cursor para utilizar el servidor creando un archivo de configuración:Para 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" ] } } }
   Para 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. Inicie el servidor utilizando uno de los scripts específicos del cliente:
   # For Cursor ./scripts/mcp_resolve-cursor_start # For Claude Desktop ./scripts/mcp_resolve-claude_start

Uso con asistentes de IA

Uso con cursor

1. Inicie el servidor Cursor usando el script dedicado:
   ./scripts/mcp_resolve-cursor_start
   O utiliza el lanzador universal:
   ./scripts/mcp_resolve_launcher.sh --start-cursor
2. Inicie Cursor y abra un proyecto.
3. En el chat de IA de Cursor, ahora puedes interactuar con DaVinci Resolve. Prueba comandos como:
   • "¿Qué versión de DaVinci Resolve está en ejecución?"
   • "Enumerar todos los proyectos en DaVinci Resolve"
   • "Crea una nueva línea de tiempo llamada 'Mi secuencia'"
   • "Añadir un marcador en la posición actual"

Uso con Claude Desktop

1. Cree un archivo claude_desktop_config.json en su directorio de configuración de Claude Desktop usando la plantilla en el directorio config-templates .
2. Ejecute el servidor Claude Desktop utilizando el script dedicado:
   ./scripts/mcp_resolve-claude_start
   O utiliza el lanzador universal:
   ./scripts/mcp_resolve_launcher.sh --start-claude
3. En Claude Desktop, ahora puedes interactuar con DaVinci Resolve usando los mismos comandos que con Cursor.

Funciones disponibles

General

• Obtenga la versión de DaVinci Resolve
• Obtener/cambiar la página actual (Editar, Color, Fusión, etc.)

Gestión de proyectos

• Lista de proyectos disponibles
• Obtener el nombre del proyecto actual
• Abrir proyecto por nombre
• Crear nuevo proyecto
• Guardar el proyecto actual

Operaciones de la línea de tiempo

• Listar todas las líneas de tiempo
• Obtenga información de la cronología actual
• Crear una nueva línea de tiempo
• Cambiar a la línea de tiempo por nombre
• Agregar marcador a la línea de tiempo

Operaciones del grupo de medios

• Lista de clips del grupo de medios
• Importar archivo multimedia
• Crear contenedor de medios
• Agregar clip a la línea de tiempo

Notas de soporte de Windows

La compatibilidad con Windows es estable en la versión v1.3.3 y no debería requerir solución de problemas adicional:

• Asegúrese de que DaVinci Resolve esté instalado en la ubicación predeterminada
• Las variables de entorno se configuran correctamente como se describe arriba
• Es posible que sea necesario ajustar las rutas de Windows según su instalación
• Si hay problemas, consulte los registros en el directorio logs/

Solución de problemas

Conexión con DaVinci Resolve

Asegúrese de que DaVinci Resolve esté en ejecución antes de iniciar el servidor. Si el servidor no puede conectarse a Resolve, compruebe lo siguiente:

1. Sus variables de entorno están configuradas correctamente
2. Tienes las rutas correctas para tu instalación de DaVinci Resolve
3. Ha reiniciado su terminal después de configurar las variables de entorno

Estructura del proyecto

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Expresiones de gratitud

• Blackmagic Design para DaVinci Resolve y su API
• El equipo de protocolo MCP para habilitar la integración del asistente de IA

Autor

Samuel Gursky ( samgursky@gmail.com )

• GitHub: github.com/samuelgursky

Planes futuros

• Compatibilidad con Windows y Linux
• Funciones adicionales de DaVinci Resolve
• Soporte para Claude Desktop

Desarrollo

Si deseas contribuir, consulta la lista de funciones en el repositorio y elige una función no implementada para trabajar en ella. El código está estructurado con secciones claras para diferentes áreas de funcionalidad.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Expresiones de gratitud

• Blackmagic Design para DaVinci Resolve y su API
• El equipo de protocolo MCP para habilitar la integración del asistente de IA

Estructura del proyecto

Después de la limpieza, el proyecto tiene la siguiente estructura:

• resolve_mcp_server.py : la implementación principal del servidor MCP
• run-now.sh : script de inicio rápido que maneja la configuración y ejecuta el servidor
• setup.sh - Script de configuración completo para la instalación
• check-resolve-ready.sh : verificación previa al lanzamiento para verificar que DaVinci Resolve esté listo
• start-server.sh - Script para iniciar el servidor
• run-server.sh - Script simplificado para ejecutar el servidor directamente

Directorios clave:

• src/ - Código fuente y módulos
• assets/ - Activos y recursos del proyecto
• logs/ - Directorio de archivos de registro
• scripts/ - Scripts de ayuda

Durante el desarrollo, se recomienda utilizar ./run-now.sh que configura el entorno y lanza el servidor en un solo paso.

Registro de cambios

Consulte docs/CHANGELOG.md para obtener un historial detallado de los cambios.

Configuración específica del cursor

Al integrar con Cursor, siga estos pasos específicos:

1. Asegúrese de que DaVinci Resolve se esté ejecutando antes de iniciar Cursor
2. Instalar las dependencias necesarias:
   # From the davinci-resolve-mcp directory: pip install -r requirements.txt
   Nota: Esto instalará el paquete MCP y otras dependencias automáticamente.
3. Configure la configuración del servidor MCP en Cursor:Cree o edite ~/.cursor/mcp.json en macOS (o %USERPROFILE%\.cursor\mcp.json en Windows):
   { "mcpServers": { "davinci-resolve": { "name": "DaVinci Resolve MCP", "command": "/path/to/your/venv/bin/python", "args": [ "/path/to/your/davinci-resolve-mcp/src/main.py" ] } } }
   Notas importantes:
   • Utilice main.py como punto de entrada (no resolve_mcp_server.py )
   • Utilice rutas absolutas en la configuración
4. Problemas comunes:
   • Error "Cliente cerrado": Verifique que las rutas sean correctas en mcp.json y que las dependencias estén instaladas
   • Problemas de conexión: asegúrese de que DaVinci Resolve se esté ejecutando antes de iniciar Cursor
   • Variables de entorno: El script main.py se encargará de configurar las variables de entorno