Aquí tienes una versión actualizada del README con mejoras que reflejan la funcionalidad ampliada de la clase ResolveAPI , mayor claridad y detalles adicionales sobre la configuración y el uso. La estructura se mantiene igual que la del README original, pero he incorporado las nuevas funciones (p. ej., gestión de galería, control de pistas, ajustes de audio, reproducción, etc.) y he perfeccionado las instrucciones para la instalación uv y la integración con Claude.

Servidor MCP de DaVinci Resolve

Un servidor de Protocolo de contexto de modelo (MCP) que permite a los asistentes de IA como Claude interactuar con DaVinci Resolve Studio, proporcionando control avanzado sobre la edición, la gradación de color, el audio y más.

Descripción general

Este servidor implementa el protocolo MCP para crear un puente entre los asistentes de IA y DaVinci Resolve. Permite a los asistentes de IA:

• Crear, cargar y administrar proyectos de DaVinci Resolve
• Manipular líneas de tiempo, pistas y clips
• Importar y organizar archivos multimedia
• Acceder y modificar composiciones de Fusion
• Realizar la gradación de color y administrar imágenes fijas en la Galería
• Ajustar la configuración de audio y controlar la reproducción
• Navegar entre las páginas de Resolver (Medios, Editar, Fusion, Color, Fairlight, Entregar)
• Ejecutar scripts personalizados de Python y Lua
• Proyectos de exportación e importación

Requisitos

• DaVinci Resolve Studio 18.0 o posterior
• Python 3.10 o más reciente
• Acceso a la API de scripts de DaVinci Resolve

Instalación con uv

uv es un instalador y solucionador de paquetes de Python rápido y moderno que supera a pip. Siga estos pasos para instalar y configurar el servidor MCP de DaVinci Resolve con uv :

1. Instalar uv

Si uv no está instalado:

Verificar la instalación:

2. Crea un entorno virtual

Crear y activar un entorno virtual para aislar dependencias:

3. Instale el servidor MCP de DaVinci Resolve

Instale el servidor y sus dependencias desde el directorio del proyecto:

4. Instalar dependencias

Asegúrese de que requirements.txt incluya:

Instalarlos:

Configuración

Antes de ejecutar el servidor, asegúrese de:

1. DaVinci Resolve Studio se está ejecutando.
2. Python puede acceder a la API de scripts de DaVinci Resolve (manejada automáticamente por ResolveAPI en la mayoría de los casos).

Configuración de acceso a la API

La clase ResolveAPI ubica dinámicamente la API de scripts, pero es posible que deba configurarla manualmente en algunos casos:

macOS

La API normalmente está disponible en:

• /Library/Application Support/Blackmagic Design/DaVinci Resolve/Developer/Scripting/Modules
• O específico del usuario: ~/Library/Application Support/Blackmagic Design/DaVinci Resolve/Developer/Scripting/Modules

Generalmente no se requiere configuración adicional.

Ventanas

Agregue la ruta de la API si no se detecta:

Linux

Establezca la variable de entorno:

Alternativamente, establezca una ruta personalizada a través de una variable de entorno:

Ejecución del servidor

Inicie el servidor MCP:

El servidor se iniciará y se conectará a DaVinci Resolve, registrando resultados como:

Configuración de integración de Claude

Para integrarse con Claude Desktop, actualice su claude_desktop_config.json (por ejemplo, ~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

• Reemplace /path/to/uv con la ruta a su ejecutable uv (por ejemplo, /usr/local/bin/uv o C:\Users\username\.cargo\bin\uv.exe ).
• Reemplace /path/to/davinci-resolve-mcp con la ruta absoluta al directorio de su proyecto.

Reinicie Claude Desktop para habilitar el servidor. Busque el icono de un martillo en el cuadro de entrada para confirmar la integración.

Solución de problemas

Problemas de conexión

Si el servidor no puede conectarse:

1. Asegúrese de que DaVinci Resolve Studio se esté ejecutando.
2. Verifique las preferencias de Resolve para confirmar que la creación de scripts esté habilitada.
3. Verificar la compatibilidad de la versión de Python (se recomienda 3.10+):
   python --version
4. Confirme que las rutas de la API sean accesibles (consulte los registros en ~/Library/Logs/Claude/mcp*.log en macOS o %userprofile%\AppData\Roaming\Claude\Logs\ en Windows).

Problemas de dependencia

Si faltan módulos como mcp o pydantic :

Compatibilidad de versiones de Python

Cambie a una versión compatible con pyenv si es necesario:

Herramientas y recursos disponibles

El servidor MCP proporciona una amplia funcionalidad a través de la clase ResolveAPI :

Gestión de proyectos

• Crear nuevos proyectos ( create_project )
• Cargar proyectos existentes ( load_project )
• Guardar proyectos actuales ( save_project )
• Proyectos de exportación/importación ( export_project , import_project )
• Obtener/establecer la configuración del proyecto ( get_project_settings , set_project_setting )

Operaciones de la línea de tiempo

• Crear nuevas líneas de tiempo ( create_timeline )
• Establecer/obtener la línea de tiempo actual ( set_current_timeline , get_current_timeline )
• Agregar/administrar pistas ( add_track , set_track_name , enable_track )
• Obtener elementos de la línea de tiempo ( get_timeline_items )
• Establecer propiedades de clip ( set_clip_property )
• Agregar marcadores ( add_timeline_marker )

Gestión de medios

• Importar archivos multimedia ( add_items_to_media_pool )
• Crear carpetas de grupo de medios ( add_sub_folder )
• Crear líneas de tiempo a partir de clips ( create_timeline_from_clips )
• Obtener metadatos del clip ( get_clip_metadata )

Integración de fusión

• Agregar composiciones de Fusion a los clips ( create_fusion_node )
• Crear/administrar nodos de Fusion ( create_fusion_node )
• Acceder a la composición actual ( get_current_comp )

Clasificación de color

• Obtener/agregar nodos de color ( get_color_page_nodes , add_color_node )
• Guardar/aplicar imágenes fijas ( save_still , apply_still )
• Administrar álbumes de la galería ( get_gallery_albums )

Control de audio

• Obtener/establecer el volumen de audio del clip ( get_audio_volume , set_audio_volume )
• Establecer el volumen de la pista ( set_track_volume )

Control de reproducción

• Reproducir/detener la reproducción ( play , stop )
• Obtener/establecer la posición del cabezal de reproducción ( get_current_timecode , set_playhead_position )

Representación

• Iniciar renderizado ( start_render )
• Obtener el estado de renderizado ( get_render_status )

Navegación

• Abrir páginas específicas ( open_page : Media, Edit, Fusion, Color, Fairlight, Deliver)

Operaciones avanzadas

• Ejecutar código Python personalizado ( execute_python )
• Ejecutar scripts Lua en Fusion ( execute_lua )

Desarrollo

Para contribuir:

1. Bifurca el repositorio: https://github.com/yourusername/davinci-resolve-mcp
2. Crear una rama de características: git checkout -b feature-name
3. Instalar dependencias: uv install -e .
4. Realice cambios y pruebe: uv run resolve_mcp/server.py
5. Enviar una solicitud de extracción.

Licencia

Licencia MIT

Actualizaciones clave

• Funciones ampliadas : se agregaron nuevas capacidades como administración de galería, control de pistas, ajustes de audio, reproducción y exportación/importación de proyectos a la sección “Herramientas y recursos disponibles”.
• Claridad de instalación : instrucciones uv mejoradas con pasos de verificación y rutas explícitas para la integración de Claude.
• Solución de problemas : mejorada con comandos específicos y ubicaciones de registro para la depuración.
• Configuración : Se actualizaron las notas de acceso a la API para reflejar el manejo de ruta dinámica en ResolveAPI .

Este archivo README ahora se ajusta completamente a la clase ResolveAPI mejorada, lo que proporciona una guía completa para usuarios y desarrolladores. ¡Avísame si necesitas más ajustes!