TouchDesigner MCP connecte des agents IA à TouchDesigner via le Model Context Protocol et le WebServer DAT de TouchDesigner. Le dépôt 8beeeaaat/touchdesigner-mcp le décrit comme un serveur MCP permettant de créer, modifier et supprimer des nœuds, lire la structure du projet, contrôler TouchDesigner par scripts Python et capturer la sortie d'un TOP sous forme d'image. Lors de la vérification GitHub du 26 août 2026, le dépôt était sous licence MIT, comptait 505 étoiles et 51 forks, et la dernière release était v2.0.0, publiée le 30 juillet 2026.
Pour Educasium, ce connecteur est pertinent pour les installations visuelles, scénographies interactives, médias temps réel et prototypes créatifs. Il parle à un outil où les graphes de nœuds, les paramètres et les retours visuels comptent plus qu'une page statique. Il faut toutefois être précis : l'installation comporte à la fois un serveur MCP Node.js et un composant TouchDesigner, les versions npm et API évoluent sur deux axes différents, et l'outil expose execute_python_script.
Sommaire
- Ce que fait TouchDesigner MCP
- Installation et architecture
- Outils exposés
- Versioning et compatibilité
- Comparaison avec Blender, Houdini et Unity
- Sécurité et limites
- Position Educasium
Ce que fait TouchDesigner MCP
À retenir : TouchDesigner MCP sert de pont entre un agent IA et un projet TouchDesigner ouvert, avec actions sur les nœuds, paramètres, scripts et images TOP. Il est conçu pour un environnement visuel temps réel, pas pour générer un site ou un rendu final hors contexte.
Un pont vers WebServer DAT
Le README explique que TouchDesigner MCP agit comme un pont entre les modèles IA et le WebServer DAT. Ce point est central : l'agent ne contrôle pas TouchDesigner par magie, il envoie des requêtes à une couche serveur exposée dans le projet. Le projet TouchDesigner doit contenir le composant mcp_webserver_base.tox, idéalement placé sous project1/mcp_webserver_base selon le guide d'installation.
Le serveur MCP peut ensuite demander des opérations sur les nœuds, les paramètres et la structure du projet. Pour des workflows créatifs, cela ouvre des usages simples : créer une base de réseau, modifier des paramètres, lire les erreurs, capturer un TOP et itérer. Pour un workflow professionnel, la même boucle doit rester observable, parce qu'une installation temps réel dépend aussi du matériel, des entrées, des performances et de la scénographie.
Pourquoi c'est différent d'un MCP 3D classique
TouchDesigner n'est pas seulement un logiciel de modélisation. Il est souvent utilisé pour des systèmes visuels temps réel, de l'interaction, des flux vidéo, des capteurs, des performances et des installations. Un connecteur MCP y a donc une valeur particulière : aider à manipuler un réseau vivant, avec des paramètres qui changent et des images de sortie à vérifier.
La commande get_top_image est importante dans cette logique. Elle capture la sortie actuelle d'un TOP sous forme d'image. Cela donne au modèle un retour visuel sur le rendu produit, même si la décision artistique et technique reste humaine. Pour Educasium, cette boucle création, capture, correction est plus formatrice qu'une simple liste de commandes.
Installation et architecture
À retenir : l'installation demande un composant TouchDesigner dans le projet et un serveur MCP lancé par bundle Claude Desktop, npm ou Docker. Oublier l'un des deux côtés coupe la connexion.
Installation côté TouchDesigner
Le guide d'installation demande d'abord de télécharger touchdesigner-mcp-td.zip depuis la dernière release, d'extraire le ZIP, puis d'importer mcp_webserver_base.tox dans le projet TouchDesigner. Il recommande le chemin project1/mcp_webserver_base. Il insiste aussi sur un point pratique : ne pas changer la structure de dossiers, car le composant référence les modules par chemins relatifs.
La dernière release vérifiée contenait deux assets : touchdesigner-mcp-td.zip et touchdesigner-mcp.mcpb. Le premier correspond au côté TouchDesigner. Le second correspond au bundle MCP pour Claude Desktop. Pour une formation, il faut donc préparer les deux fichiers et tester le Textport avant la séance.
Serveur MCP Node.js
Le package npm vérifié s'appelle touchdesigner-mcp-server, version 2.0.0, type module, avec un binaire touchdesigner-mcp-server pointant vers dist/cli.js. Le guide indique que les installations npm pour Claude Code, Codex et autres clients utilisent npx -y touchdesigner-mcp-server@latest --stdio. Il précise que Node.js 20.x ou plus récent est requis pour les installations npm.
L'architecture officielle décrit deux processus : un serveur MCP Node.js et un WebServer Python dans TouchDesigner. Le serveur Node.js peut fonctionner en stdio pour une connexion locale un-à-un, ou en mode Streamable HTTP pour des usages HTTP/SSE. Le serveur communique ensuite avec TouchDesigner via l'API HTTP exposée par le WebServer DAT, par défaut sur http://127.0.0.1:9981.
Outils exposés
À retenir : les outils couvrent création de nœuds, suppression, paramètres, introspection Python, erreurs, exécution de scripts et capture TOP. Cette couverture correspond bien à des démonstrations temps réel et à des ateliers sur les graphes TouchDesigner.
Nœuds et paramètres
La table README liste create_td_node pour créer un nœud, delete_td_node pour supprimer, get_td_nodes pour lister les nœuds sous un parent avec filtrage, get_td_node_parameters pour lire les paramètres et update_td_node_parameters pour les modifier. Elle liste aussi get_td_node_errors pour vérifier les erreurs d'un nœud et de ses enfants.
Ces commandes permettent une progression pédagogique claire. L'élève peut demander la création d'un petit réseau, lire les paramètres disponibles, modifier un réglage, puis interroger les erreurs. Dans TouchDesigner, cette boucle est importante, car une erreur de chemin, de type de nœud ou de paramètre peut rendre une partie du réseau inactive sans forcément produire une erreur visible pour le débutant.
Python, classes et image TOP
Le README liste execute_python_script pour exécuter un script Python arbitraire dans TouchDesigner, exec_node_method pour appeler une méthode Python sur un nœud, get_td_classes pour obtenir la liste des classes Python TouchDesigner, get_td_class_details pour obtenir le détail d'une classe ou d'un module, et get_td_module_help pour consulter l'aide Python. Ces outils transforment le connecteur en assistant de scripting, pas seulement en éditeur de paramètres.
get_top_image capture la sortie actuelle d'un nœud TOP comme image. Pour les installations visuelles, c'est l'outil qui rend l'itération plus concrète : l'assistant peut voir une sortie, commenter le résultat, puis proposer une correction. Cette capacité ne remplace pas une vérification sur écran réel, projecteur, LED wall ou dispositif interactif, mais elle donne une première boucle de contrôle.
Versioning et compatibilité
À retenir : TouchDesigner MCP sépare la version du package npm et la version d'API du composant TouchDesigner. C'est le piège opérationnel le plus important pour les mises à jour.
Deux axes de version
Le README explique que le serveur MCP et le composant TouchDesigner sont versionnés sur deux axes indépendants : la version du package npm et la version API, qui représente le contrat entre le serveur MCP et le composant .tox. Chaque release déclare expectedApiVersion et minApiVersion. Le minimum indiqué dans le README vérifié est 1.3.0.
Cette règle évite une erreur fréquente : croire que mettre à jour le package npm suffit. Le README dit explicitement que la version npm ne bloque jamais la compatibilité par elle-même. Ce qui compte est la compatibilité entre l'API attendue par le serveur et l'API exposée par le composant TouchDesigner.
Comportements en cas d'écart
La table de dépannage indique qu'un composant à la version API attendue fonctionne silencieusement. Une version plus ancienne mais au-dessus du minimum déclenche un avertissement de mise à jour recommandée et continue. Une version plus récente, dans le même major, déclenche aussi un avertissement. En revanche, un major au-dessus de l'attendu ou une version sous le minimum arrête l'exécution.
Le guide donne aussi la correction : télécharger le dernier touchdesigner-mcp-td.zip, remplacer le dossier existant, supprimer l'ancien composant mcp_webserver_base dans le projet, importer le nouveau .tox, puis redémarrer TouchDesigner et l'agent IA. Pour Educasium, c'est une section à garder dans le support de cours, car elle évite beaucoup de faux diagnostics.
Comparaison avec Blender, Houdini et Unity
À retenir : TouchDesigner MCP est le meilleur choix de cette liste quand le sujet est une installation visuelle temps réel ou un réseau interactif. Il n'a pas le même rôle qu'un MCP de modélisation ou de moteur de jeu.
| Option | Usage naturel | Force principale | Limite à surveiller |
|---|---|---|---|
| TouchDesigner MCP | Installations visuelles, temps réel, TOP et réseaux interactifs | Paramètres, erreurs, scripts et capture TOP | Version API du composant .tox à maintenir |
| Blender MCP | Initiation 3D, assets et scènes accessibles | Logiciel gratuit et très large communauté | Moins orienté performance live et capteurs |
| Houdini MCP | Graphes procéduraux, wrangles, VFX | Réseaux node-based et géométrie procédurale | Plus technique, centré sur Houdini |
| Unity MCP | Scènes interactives, jeux, visites temps réel | Moteur d'exécution et assets de jeu | Workflow plus lourd qu'un patch TouchDesigner |
Choisir selon la sortie attendue
Si l'objectif est une image, une scène 3D ou une asset library, TouchDesigner n'est pas forcément le point d'entrée le plus simple. Si l'objectif est une expérience temps réel qui réagit à des paramètres, un flux vidéo ou une interaction, TouchDesigner MCP devient beaucoup plus naturel.
Cette distinction aide Educasium à segmenter les cours. Un module Blender enseigne la scène 3D. Un module Houdini enseigne le procédural avancé. Un module TouchDesigner enseigne l'itération live : réseau, paramètres, sortie TOP, erreurs, performance et reprise en main humaine.
Sécurité et limites
À retenir : la capacité execute_python_script doit être traitée comme une vraie surface d'exécution dans TouchDesigner. Les gains d'automatisation ne justifient pas de laisser l'agent agir sans contrôle dans un projet client ou une installation active.
Scripts arbitraires
Le README nomme execute_python_script comme exécution d'un script Python arbitraire dans TouchDesigner. C'est utile pour inspecter, automatiser ou corriger ce que les outils structurés ne couvrent pas. C'est aussi le point qui impose des règles : travailler sur copie, relire le script, limiter les accès fichiers et ne pas tester directement sur un show file critique.
exec_node_method demande la même prudence. Appeler une méthode Python sur un nœud peut être légitime, mais cela dépend du nœud, du contexte et des effets secondaires. Dans une formation, il vaut mieux commencer par les outils structurés de lecture, paramètres et erreurs avant de passer aux scripts.
Connexion et transport
Le mode stdio est local et un-à-un, tandis que le mode Streamable HTTP peut être accessible par réseau selon la configuration. Le guide d'installation décrit aussi Docker et des variables comme MCP_HTTP_PORT ou TD_HOST pour les cas HTTP. Cela peut être utile en développement, mais ce n'est pas le choix le plus simple pour une initiation.
Les erreurs de connexion sont documentées avec des causes concrètes : TouchDesigner non lancé, WebServer DAT absent ou arrêté, port par défaut 9981 incorrect, timeout, nom d'hôte invalide. Le client met aussi en cache les échecs de connexion pendant 60 secondes pour éviter de spammer TouchDesigner. C'est un détail utile pour diagnostiquer une démo qui vient d'être réparée mais continue à répondre avec une ancienne erreur.
Position Educasium
À retenir : Educasium peut présenter TouchDesigner MCP comme un excellent cas d'étude pour l'IA appliquée aux environnements visuels temps réel, avec un fort accent sur versioning, sécurité et vérification visuelle. Le positionnement reste expérimental tant qu'une validation de production n'est pas documentée.
Formation proposée
Un atelier raisonnable commence par l'installation : importer mcp_webserver_base.tox, garder la structure de dossiers, vérifier le Textport, installer le bundle Claude Desktop ou configurer npx pour Codex, puis lancer un premier appel get_td_info. Ensuite seulement, l'atelier passe à un mini réseau : créer un nœud, lire ses paramètres, modifier une valeur, vérifier les erreurs, capturer un TOP.
Cette progression enseigne une méthode robuste. L'apprenant comprend que l'assistant a besoin d'un composant actif, d'un port correct, d'une API compatible et d'une validation visuelle. Il apprend aussi à distinguer un problème de prompt d'un problème de connexion ou de version.
Suite logique
La suite logique serait une grille Educasium pour tester les MCP temps réel : installation, port, transport, version API, outils de lecture, outils d'écriture, scripts arbitraires, capture image, performance et rollback. TouchDesigner MCP est un bon candidat pour cette grille parce qu'il documente déjà beaucoup de ces points.