DaVinci Resolve MCP : relier un assistant aux outils de montage

Le pont vers l'API de script

Le référentiel est une implémentation Python d'un serveur MCP qui expose l'API de script officielle de DaVinci Resolve Studio aux assistants IA. Il revendique une couverture complète de l'API, avec 349 méthodes sur 349, plus des assistants de flux de travail protégés pour le montage, l'organisation de la médiathèque, la configuration du rendu, les marqueurs de révision, l'étalonnage, Fusion, Fairlight et les tâches du cycle de vie du projet. Un panneau de contrôle local dans le navigateur est fourni avec le serveur pour inspecter l'état de Resolve, exécuter une analyse sûre des sources et modifier la sortie d'analyse en ligne. Le README renvoie à un guide dédié pour ce panneau.

Deux modes de serveur

Le serveur fonctionne selon deux modes. Le mode composé par défaut, démarré avec src/server.py, expose 34 outils qui regroupent les opérations Resolve associées derrière des paramètres d'action pour réduire la consommation de contexte. Le mode granulaire complet, démarré avec src/server.py --full ou src/resolve_mcp_server.py, expose 341 outils, un par méthode d'API Resolve. Le README recommande le serveur composé sauf si une surface d'un outil par méthode est spécifiquement nécessaire. Les deux modes concernent une instance Resolve active via l'API de script officielle.

Atteindre l'édition gratuite

Les scripts externes sont réservés à Studio ; dans l'édition gratuite, scriptapp("Resolve") refuse un processus étranger quel que soit le réglage. Cependant, le menu Workspace > Scripts n'est pas restreint, donc le projet fournit un script de pont qui s'exécute dans Resolve et réexporte l'objet resolve via un écouteur de boucle locale authentifié. Le pont nécessite un Python framework sur macOS, car Resolve n'énumère que les scripts .py des installations python.org. Le README indique une validation sur Free 21.0.3.7 et Studio 19.1.3.7, tous deux macOS, les chemins Windows étant ensuite confirmés par des rapports d'utilisateurs.

Un serveur compagnon hors ligne

Le même package npm inclut un deuxième serveur MCP optionnel nommé davinci-resolve-advanced-mcp, écrit en Node. Contrairement au serveur Python, il n'a pas besoin d'une instance Resolve en cours d'exécution ; il lit et modifie directement les fichiers .drp, .drt et .drx et peut appliquer des modifications au niveau de la base de données et du XML. Il propose 18 outils pour des tâches telles que le conforming, le traçage des couleurs, la planification audio et un pipeline qui compile des spécifications YAML dans une base de données SQLite. Le README indique que les écritures de grade DRX sont calibrées en direct contre Resolve Studio et que les écritures structurelles sont vérifiées par relecture du panneau, avec un statut par contrôle dans un fichier de calibration.

Ce que le projet refuse de faire

Le README est explicite sur les limites. Les médias sources sont traités comme immuables ; les outils d'analyse n'écrivent que dans des répertoires secondaires, de travail ou d'analyse de projet, et la publication de métadonnées confirmées ne se fait que dans la base de données du projet Resolve. Le serveur ne choisit pas la meilleure prise, ne coupe pas en musique et ne juge pas si un montage est bon. Tout résultat analysé mais non vérifiable est signalé comme non vérifié, et un résultat vide signifie « rien trouvé », pas « rien à trouver ». Les actions destructrices suivent une séquence planifier, vérifier, confirmer.

Installation, extras et exigences

Le démarrage rapide utilise npx davinci-resolve-mcp setup, qui installe une copie gérée et exécute un installateur Python configurant plusieurs IDE clients. Pour les installations à partir des sources, git clone et python install.py sont documentés. L'installation de base reste volontairement légère, avec Python, ffmpeg et l'API de script Resolve ; des extras optionnels comme numpy, librosa et openai-whisper débloquent des fonctionnalités d'analyse supplémentaires. Chaque extra manquant refuse honnêtement avec une ligne d'installation plutôt que de dégénérer en supposition. Les exigences sont DaVinci Resolve 18.5 ou plus récent, Python 3.10 à 3.12 comme plage à plus faible risque, et les scripts externes définis sur Local pour Studio.

Couverture des tests et licence

Le tableau des statistiques clés liste 349 méthodes d'API sur 349 couvertes, dont 338 testées en direct avec un taux de réussite de 100 %. Les tests ont été effectués contre Resolve 19.1.3 Studio, 20.3.2 Studio et 21.0.2 Studio ; les ajouts de Resolve 21 sont protégés par la détection des capacités à l'exécution. Le projet est sous licence MIT, avec des droits d'auteur attribués à DaVinci Resolve MCP Contributors et Bradford Operations LLC. La licence accorde la permission d'utiliser, copier, modifier, fusionner, publier, distribuer, sous-licencier et vendre des copies, mais fournit le logiciel sans garantie et décline toute responsabilité.

Pour évaluer SamuelGursky/davinci-resolve-mcp, il faut partir de son entrée concrète : npx davinci-resolve-mcp setup et resolve_bridge. La première passe doit utiliser un jeu d’essai isolé, une version du dépôt notée et un résultat que l’on peut relire. On vérifie d’abord que l’installation ou le chargement termine sans erreur, puis que la fonction principale produit les champs attendus. Une réussite de commande ne prouve pas encore que le projet convient à un usage durable ; elle montre seulement que la chaîne minimale est active.

La seconde passe porte sur les limites propres à SamuelGursky/davinci-resolve-mcp. Pour Termux Desktop, on compare Termux:X11 et VNC, on observe la commande tx11start --nogpu et on garde Android 12 et le Phantom Process Killer dans le journal. Pour VariantGrid, on compare les annotations VEP, les coordonnées GRCh37 et GRCh38, les échantillons partagés et la saisie ACMG. Pour AI Job Hunter, on sépare Ollama, les fournisseurs distants, SQLite et Sentry afin de savoir quelles données sortent de la machine. Pour Hackathon Starter, on teste MongoDB, l’inscription, la session, le reset et chaque callback OAuth.

Les autres dépôts demandent la même précision appliquée à leur propre surface. DaVinci Resolve MCP doit être observé avec resolve_bridge, un projet de montage et un appel en lecture seule avant toute modification. SVPullToRefresh doit arrêter l’animation après le callback et éviter les déclenchements répétés. TrendRadar doit montrer le flux, le mot-clé, la planification et la notification réellement configurés. Career-Ops doit distinguer l’import d’une offre, le contact et l’entretien. EaseMotion CSS doit vérifier les variables et les boucles dans le navigateur. js-webdav-client doit comparer les requêtes WebDAV, les réponses XML, les ACL et le fichier dist.js.

Ce protocole ne remplace pas les éléments absents du README. Les performances, la couverture des sources, la sécurité, la compatibilité des versions et le support opérationnel restent à confirmer lorsque la documentation ne les précise pas. Les équipes doivent conserver les sorties, les journaux et les fichiers d’essai avec le dépôt concerné, puis refaire uniquement les scénarios affectés par une mise à jour. La conclusion doit donc rester proportionnée : SamuelGursky/davinci-resolve-mcp peut servir dans le périmètre décrit, mais chaque extension de ce périmètre exige une preuve séparée.

Conclusion éditoriale

Le référentiel déclare une couverture de 349 méthodes d'API de script sur 349, dont 338 testées en direct, et est publié sous licence MIT.

Sources officielles

1. Official README
2. Project repository
3. Release notes