Unreal MCP connecte des clients IA comme Cursor, Windsurf et Claude Desktop à Unreal Engine via le Model Context Protocol. Le dépôt chongdashu/unreal-mcp le présente comme une intégration permettant de contrôler Unreal Engine en langage naturel, avec acteurs, Blueprints, graphe de nœuds et viewport. Lors de la vérification GitHub du 26 août 2026, le dépôt comptait 2 065 étoiles et 340 forks ; le README affichait une licence MIT, tandis que le champ licence de l'API GitHub ne remontait pas de licence détectée.
Pour Educasium, ce connecteur est intéressant, mais il doit être encadré plus strictement que Unity MCP. Le README annonce explicitement un statut expérimental : changements cassants possibles, fonctionnalités incomplètes ou instables, documentation potentiellement obsolète et usage production non recommandé. Cette phrase n'est pas un détail ; c'est le point de départ de toute page sérieuse sur Unreal MCP.
Sommaire
- Ce que fait Unreal MCP
- Architecture et installation
- Outils acteurs, éditeur et Blueprints
- Incohérences de version à vérifier
- Comparaison avec Unity, Blender et TouchDesigner
- Sécurité, limites et production
- Position Educasium
Ce que fait Unreal MCP
À retenir : Unreal MCP donne à un assistant IA des commandes pour agir dans l'éditeur Unreal, mais le dépôt le déclare expérimental et déconseille la production. La bonne lecture est donc exploration contrôlée, pas automatisation de pipeline client.
Capacités annoncées
Le README regroupe les capacités en quatre familles. Actor Management couvre la création et suppression d'acteurs, les transformations, les propriétés, la recherche par nom et la liste des acteurs dans le niveau courant. Blueprint Development couvre la création de classes Blueprint, les composants, les propriétés, la physique, la compilation et le spawn d'acteurs Blueprint.
Blueprint Node Graph couvre l'ajout d'événements, les appels de fonctions, les connexions de nœuds, les variables et les références à composants ou self. Editor Control couvre le focus du viewport sur un acteur ou une position, ainsi que l'orientation et la distance de caméra. Cette couverture est cohérente avec un prototype Unreal, mais elle n'est pas présentée comme stable.
Pourquoi le statut expérimental change tout
La section Experimental Status du README est directe. Elle dit que l'API, les fonctionnalités et les détails d'implémentation peuvent changer de façon importante. Elle prévient que des breaking changes peuvent arriver sans préavis, que les fonctionnalités peuvent être incomplètes ou instables, que la documentation peut être obsolète ou manquante, et que l'usage production n'est pas recommandé à ce stade.
Pour une page Educasium, cette mise en garde doit être visible avant les exemples. Sans elle, le lecteur pourrait croire qu'Unreal MCP est équivalent à un outil mature comme Unity MCP. Ce n'est pas ce que dit le dépôt. La valeur actuelle est dans l'expérimentation et l'apprentissage des ponts MCP vers moteurs temps réel.
Architecture et installation
À retenir : Unreal MCP combine un plugin C++ dans Unreal et un serveur Python MCP qui communique avec le plugin par socket TCP. Le README indique le port 55557 pour la connexion entre serveur Python et plugin.
Composants du dépôt
Le dépôt contient MCPGameProject, un projet Unreal exemple basé sur un Blank Project avec le plugin UnrealMCP déjà ajouté. Il contient aussi MCPGameProject/Plugins/UnrealMCP, qui porte le plugin C++ natif, et Python/unreal_mcp_server.py, qui implémente le serveur Python. Le README dit que le plugin intègre les sous-systèmes de l'éditeur Unreal, implémente des outils de manipulation d'acteurs et gère l'exécution des commandes et réponses.
Le serveur Python gère les connexions TCP vers le plugin C++ sur le port 55557, sérialise les commandes, parse les réponses, gère les erreurs et charge les modules d'outils depuis le dossier Python/tools. Les modules vérifiés sont blueprint_tools.py, editor_tools.py, node_tools.py, project_tools.py et umg_tools.py.
Installation pratique
Le README demande Unreal Engine 5.5+, Python et un client MCP comme Claude Desktop, Cursor ou Windsurf. Pour démarrer vite, il propose d'utiliser MCPGameProject, générer les fichiers Visual Studio, ouvrir la solution, choisir Development Editor et build. Pour un projet existant, il faut copier MCPGameProject/Plugins/UnrealMCP dans le dossier Plugins du projet, activer le plugin dans Edit > Plugins, redémarrer l'éditeur, générer les fichiers Visual Studio et compiler.
La configuration MCP exemple utilise la commande uv avec --directory pointant vers le dossier Python, puis run unreal_mcp_server.py. Le fichier mcp.json du dépôt montre la même structure. Cela confirme que l'assistant MCP ne parle pas directement à Unreal : il lance un serveur Python qui parle ensuite au plugin C++.
Outils acteurs, éditeur et Blueprints
À retenir : les docs détaillent surtout acteurs, viewport et Blueprints ; le dépôt contient aussi des modules pour nœuds, projet et UMG. Il faut donc décrire la couverture sans promettre un éditeur Unreal complet.
Acteurs et viewport
La documentation Actor Tools liste get_actors_in_level, find_actors_by_name, create_actor, delete_actor, set_actor_transform et get_actor_properties. Les types d'acteurs supportés pour create_actor incluent CUBE, SPHERE, CYLINDER, PLANE, POINT_LIGHT, SPOT_LIGHT, DIRECTIONAL_LIGHT, CAMERA et EMPTY. Les notes d'implémentation précisent que les transforms doivent être des listes de trois floats et que les types d'acteurs doivent être fournis en majuscules.
La documentation Editor Tools liste focus_viewport et take_screenshot. focus_viewport peut cibler un acteur ou une position, avec distance et orientation. take_screenshot capture le viewport avec un nom de fichier, une option show_ui et une résolution. Ces outils sont utiles pour une démonstration visuelle, mais la doc elle-même inclut des erreurs possibles comme viewport actif introuvable ou acteur absent.
Blueprints
La documentation Blueprint Tools couvre create_blueprint, add_component_to_blueprint, set_static_mesh_properties, set_component_property, set_physics_properties, compile_blueprint et set_blueprint_property dans la partie vérifiée. Le README ajoute que l'intégration peut créer des classes Blueprint, ajouter et configurer composants, définir propriétés et physique, compiler les Blueprints et créer des mappings d'input.
Pour Educasium, cette zone est intéressante parce qu'elle rapproche l'assistant IA du langage visuel d'Unreal. Elle est aussi risquée. Un Blueprint qui compile peut rester mal architecturé, fragile ou incompatible avec la convention projet. La démonstration doit donc rester petite : créer un Blueprint simple, ajouter un composant, compiler, placer un acteur et vérifier le viewport.
Incohérences de version à vérifier
À retenir : les fichiers du dépôt ne disent pas tous la même chose sur la version Python minimale. La bonne instruction est de vérifier l'environnement au moment de l'installation.
Unreal et Python
Le README racine affiche un badge Unreal Engine 5.5+ et Python 3.12+. Le Python/README.md dit, lui, de s'assurer que Python 3.10+ est installé. Le pyproject du dossier Python déclare requires-python >=3.10, une version 0.1.0 et des dépendances comme mcp[cli] >=1.4.1, fastmcp >=0.2.0, uvicorn, fastapi, pydantic et requests.
Cette divergence n'empêche pas de tester le projet, mais elle doit être mentionnée. Dans un atelier, le plus sûr est de préparer l'environnement à l'avance et de noter la version Python réellement utilisée par uv. Dans un studio, il faut documenter Unreal, Python, plugin, serveur et client MCP dans un journal d'installation.
Documentation encore jeune
Les docs indexent Actor Tools, Editor Tools et Blueprint Tools, mais le dossier Python/tools contient aussi node_tools.py, project_tools.py et umg_tools.py. Cela correspond au warning du README : la documentation peut être obsolète ou incomplète. Il ne faut pas transformer une absence de page détaillée en absence de capacité, ni l'inverse.
La bonne méthode est de partir des docs publiées pour les exemples et de vérifier le code quand une capacité précise devient importante. Pour une page SEO, on peut citer les modules vérifiés, mais pour une formation technique, il faudrait tester chaque outil dans Unreal avant de l'inclure dans un exercice.
Comparaison avec Unity, Blender et TouchDesigner
À retenir : Unreal MCP est une piste d'expérimentation pour Unreal Engine, tandis que Unity MCP paraît plus mature et documenté au moment de cette vérification. Le choix ne doit pas être fait uniquement sur la préférence moteur.
| Option | Usage naturel | Force principale | Limite à surveiller |
|---|---|---|---|
| Unreal MCP | Exploration Unreal, acteurs, Blueprints, viewport | Accès moteur Unreal et graphes Blueprint | Statut expérimental et production déconseillée |
| Unity MCP | Prototypes Unity, scènes, scripts, tests, builds | Manifest riche, sécurité documentée, large adoption | Exécution C# et mutations projet à contrôler |
| Blender MCP | Modélisation 3D et assets accessibles | Bon point d'entrée pour scène et rendu | Moins adapté aux projets moteur complets |
| TouchDesigner MCP | Installations visuelles temps réel | Nœuds live, paramètres, TOP image | Version API .tox et scripts Python à surveiller |
Choisir selon maturité et risque
Si l'objectif est une formation Unreal exploratoire, Unreal MCP est pertinent : il montre comment un MCP peut piloter acteurs, viewport et Blueprints. Si l'objectif est un pipeline réel avec tests, builds et sécurité documentée, Unity MCP semble aujourd'hui plus solide dans les sources vérifiées.
Pour une initiation 3D simple, Blender reste plus accessible. Pour une installation temps réel, TouchDesigner parle mieux aux graphes live et aux sorties TOP. Unreal MCP doit donc être présenté comme un sujet avancé, avec un protocole de test plus strict que les connecteurs déjà matures.
Sécurité, limites et production
À retenir : le README déconseille explicitement la production ; cette limite encadre le positionnement. Toute démonstration doit être faite sur projet exemple ou copie.
Pourquoi rester en sandbox
Unreal MCP agit dans un éditeur Unreal via un plugin natif et un serveur Python. Même si les docs vérifiées se concentrent sur acteurs, viewport et Blueprints, ce type d'outil peut modifier une scène, créer des assets, compiler des Blueprints et produire des fichiers. Une erreur peut casser un projet, polluer un niveau ou générer une structure difficile à maintenir.
La meilleure règle est de partir du MCPGameProject fourni, puis de travailler sur copies. Il faut contrôler les fichiers modifiés, lire les logs, garder des commits fréquents dans le projet Unreal et ne jamais lancer une démonstration sur un projet client unique. Le dépôt lui-même donne assez de raisons pour cette prudence.
Que vérifier avant d'aller plus loin
Avant tout atelier, vérifier Unreal Engine 5.5+, Visual Studio ou toolchain de build, plugin activé, serveur Python installé, uv fonctionnel, port 55557 disponible, client MCP configuré et logs unreal_mcp.log lisibles. Vérifier aussi que le viewport actif existe avant les commandes de capture ou focus.
Avant toute recommandation professionnelle, ajouter une couche d'évaluation : stabilité sur plusieurs sessions, comportement après crash, gestion des erreurs, périmètre fichier, sécurité réseau, compatibilité avec le contrôle de version Unreal et validation par un développeur Unreal. Sans cela, le positionnement reste au niveau étude et expérimentation.
Position Educasium
À retenir : Educasium peut présenter Unreal MCP comme un cas d'étude avancé, pas comme un outil prêt à intégrer dans les workflows client. L'honnêteté sur le statut expérimental renforce la crédibilité de la page.
Formation proposée
Un module Educasium raisonnable commence avec le projet exemple MCPGameProject. Il montre la compilation du plugin, le lancement du serveur Python, la configuration du client MCP, puis une séquence courte : lister les acteurs, créer un cube, déplacer l'acteur, focaliser le viewport et prendre une capture. Ensuite seulement, il peut créer un Blueprint simple, ajouter un composant, compiler et placer l'acteur.
Cette progression garde les risques visibles. L'apprenant comprend la chaîne C++ plugin, Python server, client MCP et Unreal Editor. Il voit aussi que les erreurs font partie du sujet, surtout dans un projet expérimental.
Suite logique
La suite logique serait une grille Educasium pour moteurs temps réel expérimentaux : maturité du dépôt, avertissements README, versions, plugin natif, surface de modification, logs, rollback, tests de scène, stabilité et preuves visuelles. Unreal MCP est utile précisément parce qu'il oblige à enseigner cette rigueur.