Unity MCP, publié par CoplayDev, connecte des assistants IA à l'éditeur Unity via le Model Context Protocol. Le dépôt CoplayDev/unity-mcp le décrit comme un pont permettant de gérer des assets, contrôler des scènes, éditer des scripts, lancer des tests et automatiser des workflows Unity. Lors de la vérification GitHub du 26 août 2026, le dépôt était sous licence MIT, comptait 13 672 étoiles et 1 452 forks, et sa branche par défaut était beta.
Pour Educasium, c'est un connecteur important parce qu'il touche un moteur complet, pas seulement un logiciel de dessin ou un graphe visuel. Unity MCP peut aider à créer des GameObjects, modifier des scènes, gérer composants, assets, prefabs, matériaux, scripts, tests, builds, VFX, animation, UI et profiling. Il faut toutefois l'enseigner avec prudence : le manifest vérifié expose execute_code pour exécuter du C# arbitraire dans l'éditeur Unity, et la politique de sécurité insiste sur les protections réseau et le périmètre fichier.
Sommaire
- Ce que fait Unity MCP
- Installation et architecture
- Outils et familles de capacités
- Sécurité et réseau
- Tests, builds et usages avancés
- Comparaison avec Unreal, Blender et TouchDesigner
- Position Educasium
Ce que fait Unity MCP
À retenir : Unity MCP donne à un client MCP des outils pour agir dans l'éditeur Unity, depuis la scène jusqu'aux scripts, tests et builds. Sa portée est beaucoup plus large qu'un connecteur de modélisation 3D.
Un pont vers l'éditeur Unity
Le README dit que MCP for Unity relie Claude, Codex, VS Code, modèles locaux et autres clients MCP à l'éditeur Unity. Il met en avant la gestion d'assets, le contrôle de scènes, l'édition de scripts, les tests, le profiling et les builds. La section What it does annonce 47 points d'entrée MCP focalisés. Le manifest vérifié, lui, liste 43 outils nommés. Cette différence doit être présentée comme un écart entre sources, pas comme une erreur à masquer.
Les deux sources concordent sur l'idée générale : l'assistant peut agir sur un projet Unity ouvert. Pour une visite virtuelle, un prototype pédagogique ou une scène interactive, cela peut aider à produire une première structure plus vite. Mais Unity reste un moteur complet avec état projet, packages, assets, compilation, play mode et plateformes de build. Une commande réussie ne remplace pas la validation d'un développeur Unity.
Un projet open source mais non affilié à Unity Technologies
Le README indique que le projet est gratuit, open source et sous licence MIT, mais précise qu'il n'est pas affilié à Unity Technologies. Cette nuance compte. CoplayDev maintient le dépôt, et le README mentionne Aura comme sponsor et mainteneur, mais l'outil n'est pas un produit Unity officiel.
Pour Educasium, le bon positionnement est donc : outil open source très populaire, utile à explorer, mais à auditer avant intégration professionnelle. Les studios doivent vérifier version Unity, politique de packages, sécurité, accès fichiers, réseau, scripts et compatibilité avec leur pipeline.
Installation et architecture
À retenir : Unity MCP combine un package Unity côté éditeur et un serveur Python lancé par uvx côté client MCP. Le README annonce Unity 2021.3 LTS à Unity 6.x et Python 3.10 ou plus récent.
Installation Unity
Le quickstart demande d'installer le package via Unity Package Manager avec une URL Git pointant vers MCPForUnity, ou de pinner la release v10.0.0, ou d'utiliser OpenUPM avec le package com.coplaydev.unity-mcp. Le package Unity vérifié sur la branche beta déclare le nom com.coplaydev.unity-mcp, la version 10.1.3-beta.4, Unity 2021.3 comme version minimale, et des dépendances Unity comme animation, physics, physics2d, uielements, screencapture, unitywebrequest, Newtonsoft JSON et Unity Test Framework.
Après installation, le README demande d'utiliser Window, MCP for Unity, Configure All Detected Clients. Cette étape indique que le package essaie de configurer plusieurs clients MCP. Le dépôt contient effectivement des configurateurs pour Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Cline, Gemini CLI, Codex, Rider et d'autres clients. Cette variété est intéressante pour une formation, parce que les apprenants peuvent travailler dans l'outil qu'ils utilisent déjà.
Serveur MCP
Le manifest MCP vérifié déclare Unity MCP en version 10.1.2, avec un serveur de type Python et un entry point Server/src/main.py. Sa configuration MCP utilise uvx avec mcpforunityserver et mcp-for-unity. Le README exige Python 3.10 ou plus récent via uv.
Le dépôt contient aussi un dossier Server et un fichier mcp_source.py, ce qui confirme la séparation entre serveur MCP et package Unity. Le bon diagnostic d'installation doit donc vérifier deux côtés : le package dans Unity et le serveur MCP dans le client. Si l'assistant ne voit pas Unity, le problème peut venir de la configuration du client, du serveur Python, du package Unity, du port, de la version ou de l'état de l'éditeur.
Outils et familles de capacités
À retenir : le manifest couvre des familles très larges : scripts, scènes, GameObjects, composants, assets, prefabs, matériaux, UI, VFX, animation, physique, profiling, tests et builds. Cette largeur est la force et le risque du connecteur.
Scènes, GameObjects et assets
Le manifest liste manage_scene pour charger, sauvegarder, interroger hiérarchie, édition multi-scène, templates, validation et gestion de scènes. Il liste manage_gameobject pour créer, modifier, transformer et supprimer des GameObjects, manage_components pour ajouter, retirer et configurer des composants, manage_prefabs pour créer, instancier, unpack et modifier des prefabs, et manage_asset pour créer, modifier, chercher et organiser les assets.
Pour Educasium, ces outils rendent possible une démonstration de visite virtuelle : créer une scène, placer des objets, ajouter caméra, lumières, composants et matériaux, puis inspecter le résultat. Mais cette démonstration doit rester contrôlée. Les assets et prefabs peuvent porter des scripts, des références manquantes, des licences et des dépendances packages.
Scripts, C# et validation
La partie script est centrale. Le manifest liste create_script, manage_script, apply_text_edits, script_apply_edits, find_in_file, validate_script, get_sha, manage_script_capabilities et execute_code. La description de execute_code dit qu'il exécute du C# arbitraire dans l'éditeur Unity avec accès aux API Unity.
Cette capacité peut accélérer le prototypage, mais elle doit être cadrée. Pour une formation, on peut l'utiliser sur un projet sandbox pour créer un composant simple et le valider. Pour un projet client, il faut relire le code, lancer les tests, vérifier la console, sauvegarder le projet et éviter d'exécuter des instructions non comprises.
Sécurité et réseau
À retenir : la politique de sécurité de Unity MCP décrit des protections par défaut, mais l'outil reste capable de modifier un projet Unity et d'exécuter du code. Les protections réduisent le risque, elles ne l'annulent pas.
Défauts réseau
La politique de sécurité indique que MCP for Unity est conçu pour échouer fermé. Le mode HTTP local se lie par défaut à la loopback, comme 127.0.0.1, localhost ou ::1. Le bind LAN sur 0.0.0.0 ou :: demande un opt-in explicite dans les paramètres avancés. Le mode HTTP distant exige https par défaut, et le http distant en clair demande aussi un opt-in. Le mode remote-hosted demande une authentification par clé API.
Ces choix sont importants pour un moteur comme Unity. Un connecteur exposé au réseau sans contrôle pourrait devenir une surface d'attaque. Pour Educasium, le message doit être clair : garder le mode local pour les ateliers, ne pas exposer l'éditeur sur le LAN sans raison, et traiter tout contournement des gardes comme un incident de sécurité.
Ce que le projet considère comme vulnérable
Le fichier SECURITY.md demande de ne pas signaler les vulnérabilités en public et de contacter security@coplay.dev. Il cite comme problèmes de sécurité l'exécution de code à distance via messages MCP forgés, le contournement d'authentification du serveur remote-hosted, les lectures ou écritures hors racine projet Unity prévue, les requêtes réseau hors allow-list, et les fuites de credentials ou clés API dans logs, télémétrie ou erreurs.
La même politique dit que les anciennes releases ne sont pas supportées et qu'il faut mettre à jour. Pour un studio, cela implique une vraie discipline de version : documenter la version du package Unity, la version du serveur Python, le client MCP utilisé et le niveau d'accès réseau.
Tests, builds et usages avancés
À retenir : Unity MCP va jusqu'aux tests, builds, profiling, documentation Unity et réflexion C# live. Cela en fait un outil de développement, pas seulement un outil créatif.
Tests et builds
Le manifest liste run_tests et get_test_job pour lancer et suivre les tests Unity Test Framework, manage_build pour déclencher des builds, changer de plateforme, configurer les réglages et effectuer des builds batch, puis read_console pour lire logs, warnings et erreurs de l'éditeur. Il liste aussi refresh_unity pour rafraîchir la base d'assets.
Cette couverture est importante pour éviter une mauvaise pratique : générer une scène et ne jamais vérifier le projet. Un module Educasium devrait inclure lecture console, validation script, tests et sauvegarde. Le résultat attendu n'est pas seulement "un cube apparaît" ; c'est un projet qui compile et peut être repris par un humain.
Profiling, animation, UI et VFX
Le manifest liste manage_profiler pour piloter Unity Profiler, lire des compteurs, prendre des snapshots mémoire et utiliser le Frame Debugger. Il liste manage_animation, manage_camera, manage_graphics, manage_physics, manage_shader, manage_texture, manage_ui et manage_vfx. Les guides avancés du README pointent aussi vers multi-instance routing, tool groups, migration v10, validation Roslyn et remote server auth.
Ces familles rendent le connecteur puissant, mais elles demandent un cours structuré. Une session débutant ne devrait pas activer toutes les familles d'outils. Le plus raisonnable est de démarrer avec scène, GameObject, matériau, caméra, console et validation script, puis d'ouvrir les groupes avancés selon le besoin.
Comparaison avec Unreal, Blender et TouchDesigner
À retenir : Unity MCP est le meilleur choix quand l'objectif est un projet interactif Unity réel, avec scènes, scripts, tests et builds. Il est plus lourd qu'un outil de modélisation, mais plus proche d'un livrable interactif.
| Option | Usage naturel | Force principale | Limite à surveiller |
|---|---|---|---|
| Unity MCP | Jeux, visites virtuelles, prototypes interactifs, outils Unity | Scènes, scripts, assets, tests, builds et profiling | Exécution C# et mutations projet à contrôler |
| Unreal MCP | Rendus temps réel Unreal, acteurs, Blueprints | Intégration moteur Unreal expérimentale | Le dépôt annonce lui-même prudence production |
| Blender MCP | Modélisation 3D accessible et assets | Gratuit, très bon pour initiation scène | Moins adapté aux builds applicatifs |
| TouchDesigner MCP | Installations visuelles temps réel | Graphes live, paramètres, TOP image | Moins naturel pour game logic et build multi-plateforme |
Choisir selon le livrable
Si le livrable est une image ou un asset 3D, Blender peut suffire. Si le livrable est une installation temps réel sans logique jeu complète, TouchDesigner peut être plus direct. Si le livrable est une application interactive, une visite virtuelle ou un prototype avec tests et builds, Unity MCP devient plus pertinent.
Le connecteur Unreal doit être étudié séparément, surtout parce que son dépôt annonce un statut expérimental dans la fiche courte existante. Pour Educasium, Unity et Unreal ne doivent pas être présentés comme interchangeables : ils correspondent à des équipes, pipelines et risques différents.
Position Educasium
À retenir : Educasium peut présenter Unity MCP comme un outil puissant pour enseigner l'IA appliquée à un moteur interactif, mais seulement avec un protocole de test et de sécurité. Le positionnement reste pédagogique tant qu'aucun usage Educasium en production n'est vérifié.
Formation recommandée
Un atelier raisonnable démarre par un projet Unity vide ou sandbox, installe le package, configure le client MCP, crée un cube, ajoute un Rigidbody, lit la console, sauvegarde la scène et valide un script simple. Ensuite, il peut passer à la création de matériaux, caméra, prefab, UI ou test.
Cette progression évite deux pièges. Le premier est de demander trop vite une scène complète et de perdre la capacité de vérifier. Le second est de laisser execute_code produire du C# sans relecture. L'objectif pédagogique doit être d'apprendre une boucle : demander, observer, compiler, tester, sauvegarder, reprendre la main.
Suite logique
La suite logique est une grille Educasium pour les MCP moteurs temps réel : installation, versions, surface d'exécution, accès fichiers, sécurité réseau, logs, tests, builds, profiling, asset pipeline et rollback. Unity MCP est un bon candidat pour cette grille parce que sa documentation de sécurité et son manifest exposent clairement les zones de puissance et de risque.