davinci-resolve-mcp MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

27 herramientas cubriendo 324 de 324 métodos de API de Resolve (100%)
Instalador universal configura automáticamente Claude Desktop/Code, Cursor, VS Code, Windsurf, Zed, JetBrains
Manipulación de timelines: pistas, marcadores, clips, generadores, títulos
Transformación, recorte, composición, remuestreo y fotogramas clave por clip
API de grafo de nodos Fusion para automatización de motion graphics

Demo en vivo

Cómo se ve en la práctica

davinci-resolve.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "davinci-resolve": {
      "command": "uvx",
      "args": [
        "davinci-resolve-mcp"
      ],
      "_inferred": true
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "davinci-resolve": {
      "command": "uvx",
      "args": [
        "davinci-resolve-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "davinci-resolve": {
      "command": "uvx",
      "args": [
        "davinci-resolve-mcp"
      ],
      "_inferred": true
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "davinci-resolve": {
      "command": "uvx",
      "args": [
        "davinci-resolve-mcp"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "davinci-resolve",
      "command": "uvx",
      "args": [
        "davinci-resolve-mcp"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "davinci-resolve": {
      "command": {
        "path": "uvx",
        "args": [
          "davinci-resolve-mcp"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add davinci-resolve -- uvx davinci-resolve-mcp

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: davinci-resolve-mcp

Construir un rough cut a partir de un script + carpeta de footage

👤 Editores de video creando contenido de talking-head ⏱ ~20 min intermediate

Cuándo usarlo: Tienes 2 horas de B-roll y un script de 3 páginas y no quieres empezar en una timeline vacía.

Requisitos previos

DaVinci Resolve Studio 18.5+ abierto — Compra una sola vez ($295) — la edición gratuita no tiene API de scripting
Preferencias de Resolve: System > General > External scripting using: Local — Reinicia Resolve después de cambiarlo
MCP instalado mediante el instalador universal — git clone samuelgursky/davinci-resolve-mcp && python install.py

Flujo

Crear proyecto e importar media

Crea un nuevo proyecto 'EP04_RoughCut', 1080p24, e importa cada .mov en ~/Footage/EP04 a una carpeta de Media Pool llamada 'B-roll'.✓ Copiado

→ Proyecto abierto con carpeta poblada
Construir una timeline sincronizada con los beats del script

Crea una nueva timeline. Para cada párrafo en ~/Footage/EP04/script.md, agrega un marcador de 6 segundos en la pista V2 etiquetado con las primeras 5 palabras.✓ Copiado

→ Timeline con marcadores de beats
Coloca B-roll en cada marcador

En cada marcador, elige el clip de B-roll que más coincida por palabra clave del nombre de archivo y colócalo en V1 en ese marcador.✓ Copiado

→ El corte se ensambla visiblemente

Resultado: Un rough cut que puedes refinar manualmente, construido en 5 minutos en lugar de una hora.

Errores comunes

La coincidencia basada en nombres de archivo es imprecisa — Renombra los clips con prefijos descriptivos, o utiliza el aislamiento de voz integrado de Resolve / transcripción para una coincidencia más inteligente
Resolve es lento mientras se ejecutan herramientas MCP en proyectos enormes — Trabaja en un proyecto de 'ensamblaje' más pequeño; conforma al proyecto grande después

Combinar con: filesystem

Aplicar un preset de color por lotes en toda la timeline

👤 Coloristas haciendo trabajo de asistente ⏱ ~15 min intermediate

Cuándo usarlo: Quieres aplicar una LUT base + aumento de saturación en 60 clips antes de comenzar la corrección de color manual.

Flujo

Inspeccionar la estructura de la timeline

Lista cada clip en la timeline activa con entrada/salida y nombre de archivo de origen.✓ Copiado

→ Inventario de clips
Aplicar preset

Para cada clip, aplica Power Grade 'EP04_Base' como el primer nodo.✓ Copiado

→ Actualización de miniaturas
Marca los clips que se ven mal

¿Qué clips se ven significativamente fuera del rango normal después del preset? Sugiere ajustes por clip.✓ Copiado

→ Lista corta de clips que necesitan atención manual

Resultado: Una corrección de base consistente aplicada en segundos, con marcas de atención manual.

Exportar múltiples deliverables desde una timeline

👤 Editores entregando a YouTube + Instagram + broadcast ⏱ ~10 min beginner

Cuándo usarlo: Mismo corte, tres especificaciones de exportación, no quieres hacer clic en la página de renderizado tres veces.

Flujo

Encola los tres renders

Encola renders para la timeline activa: YouTube 1080p H.264 a ~/Exports/yt.mp4, Instagram 1080x1350 a ig.mp4, ProRes 422 HQ a broadcast.mov.✓ Copiado

→ 3 trabajos en la cola de renderizado
Inicia y monitorea

Inicia todos los trabajos encolados e informa cuando terminen.✓ Copiado

→ Estado de finalización por trabajo

Resultado: Una entrega multi-formato en un turno de chat.

Combinar con: filesystem

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

davinci-resolve + filesystem

Leer un script/EDL del disco y hacer un corte basado en él

Lee ~/Project/EP04/edl.txt y construye una timeline coincidente en el proyecto Resolve actual.✓ Copiado

davinci-resolve + after-effects

Termina VFX en AE y luego conforma de vuelta en Resolve

Después de que se completen los renders de AE en ~/renders/vfx/, reemplaza los clips de marcador de posición correspondientes en la timeline de Resolve con los nuevos archivos.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
resolve	action: str, params?: object	A nivel de aplicación: páginas, diseño, presets de renderizado	gratuito (local)
project_manager	action, params	Crear/abrir/eliminar proyectos, bases de datos, nube	gratuito
project	action, params	Timelines, tubería de renderizado, configuración, LUTs	gratuito
media_pool	action, params	Importar, organizar clips y timelines	gratuito
timeline	action, params	Pistas, marcadores, elementos, generadores	gratuito
timeline_item	action, params	Propiedades por clip, composiciones Fusion, versiones, CDL	gratuito
timeline_item_transform	item_id, pan?, tilt?, zoom?, rotation?	Reposicionar/redimensionar un clip	gratuito
timeline_item_keyframes	item_id, property, frame, value	Animar cualquier propiedad que pueda tener fotogramas clave	gratuito
gallery	action, params	Fotogramas fijos y Power Grades	gratuito
fusion_comp	action, params	Construir/modificar grafos de nodos Fusion	gratuito

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Sin red — todo es API de scripting local
Tokens por llamada: La mayoría de respuestas 200-800 tokens; los volcados de timeline pueden alcanzar 5k en ediciones grandes
Monetario: DaVinci Resolve Studio de una sola vez ~$295 (requerido). MCP en sí es gratuito/MIT.
Consejo: El costo es Resolve Studio y tu tiempo de renderizado; las llamadas de API son gratuitas. Solicita listas con alcance (1 timeline, 1 pista) no volcados completos del proyecto.

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Sin credenciales — solo scripting local

Salida de datos: Ninguno. Todas las llamadas de API permanecen dentro de Resolve.

No conceder nunca: Exposición de red remota del MCP — mantenla local

Habilita 'External scripting using: Local' — nunca 'Network' a menos que poseas la red de extremo a extremo.
El MCP tiene control total del proyecto; no ejecutes experimentos en el proyecto que estás entregando hoy.

Resolución de problemas

Errores comunes y soluciones

No connection to DaVinci Resolve

Resolve debe estar ejecutándose y 'External scripting using: Local' habilitado; reinicia Resolve después de cambiarlo.

Verificar: Preferences > System > General shows Local

Free edition: scripting disabled

La edición gratuita no expone la API de scripting. Actualiza a Studio.

Python version mismatch on macOS

El instalador prefiere Python 3.10-3.12. Utiliza pyenv install 3.11.9 y ejecuta de nuevo install.py.

Verificar: python3 --version

Operations time out on a 4K project

La API de scripting de Resolve es de un solo subproceso y se encola detrás de actualizaciones de UI. Minimiza los paneles de visor de Resolve durante operaciones por lotes grandes.

Alternativas

davinci-resolve-mcp vs otros

Alternativa	Cuándo usarla	Contrapartida
Adobe Premiere MCPs (community)	Tu flujo de trabajo es Premiere, no Resolve	Ecosistema MCP menos maduro para Premiere
After Effects MCP	Estás haciendo motion graphics, no edición/color	Etapa diferente del flujo de trabajo
Raw Python + Resolve API	Quieres control total y no necesitas IA	Sin MCP = sin interfaz de chat

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills