MCP UEFN

MCP UEFN intègre un serveur MCP dans le processus Unreal Editor pour Fortnite afin que tout agent IA compatible MCP, comme Claude Code, Cursor ou MCP Inspector, puisse piloter l'éditeur via une connexion HTTP locale.

Il propose les fonctionnalités suivantes propres à l'UEFN : 

• Création et modification d'entités Scene Graph Verse

• Lecture et écriture de fichiers Verse

• Placement d'appareils du mode Créatif et modification de leurs propriétés

• Démarrage, arrêt et inspection d'une session de jeu

Qu'est-ce que MCP ?

UEFN MCP intègre un serveur Model Context Protocol (MCP) au processus de l'éditeur de l'UEFN. Tout agent d'IA compatible MCP peut s'y connecter via une connexion HTTP en local et piloter l'éditeur à l'aide d'outils typés regroupés dans des trousses à outils. L'éditeur peut ainsi être inspecté et utilisé par un agent, qui peut lire du Verse, modifier le graphe de scène, placer et configurer des appareils du mode Créatif et lancer une session de jeu. 

Une fois la configuration terminée et l'agent (comme Claude Code) connecté à l'éditeur en cours d'exécution, vous pouvez commencer à poser des questions ou à donner des instructions en langage naturel. En voici quelques exemples :

• Quels appareils puis-je placer ?

• Ajoute un journal au démarrage de la manche et compile-le.

• Lance une session pour que je puisse tester.

Avec ces types de questions et de directives, l'agent découvre les trousses à outils disponibles, appelle les outils et vous communique les résultats. 

Conditions préalables pour UEFN MCP

Pour pouvoir utiliser UEFN MCP, vous devez d'abord configurer les éléments suivants dans le projet.

1. Activez l'éditeur de scripts Python pour le projet.

2. Configurez le démarrage automatique de MCP.

3. Générez un fichier de configuration client.

4. Démarrez un agent IA depuis le répertoire d'installation de l'UEFN Fortnite.

Activer Python et UEFN MCP

Dans vos paramètres de projet, cochez les cases Éditeur de scripts Python et Trousses à outils UEFN MCP.

Configurer le démarrage automatique de MCP

Pour configurer le démarrage automatique de MCP :

• Ouvrez Modifier > Préférences de l'éditeur.

• Dans le groupe Général, sélectionnezModel Context Protocol.

Cela fait apparaître le paramètre Démarrage automatique du serveur qui, lorsqu'il est activé, démarre automatiquement le serveur MCP à chaque lancement de l'éditeur, liant le serveur MCP à http://127.0.0.1:8000/mcp. 

Ce même panneau permet également de définir le port d'écoute (8000 par défaut) et le chemin de l'URL (/mcp par défaut) si ces valeurs par défaut entrent en conflit avec un autre service local. Le nom du serveur indiqué dans ServerInfo.name est toujours unreal-mcp.

Si vous souhaitez plutôt démarrer le serveur à la demande, désactivez Démarrage automatique du serveur et saisissez ModelContextProtocol.StartServer dans la console de l'éditeur.

La commande accepte également un port facultatif : ModelContextProtocol.StartServer:8000.

Créer une configuration client

Chaque agent IA attend sa liste de serveurs dans un format de fichier spécifique et à un emplacement spécifique dans l'arborescence du projet. Il doit connaître l'emplacement d'installation de l'UEFN. 

Pour y accéder rapidement, vous pouvez consulter l'emplacement des fichiers de votre installation depuis le lanceur pour ouvrir directement le dossier correspondant.

Une fois que vous avez trouvé l'emplacement où sont stockés les fichiers d'installation de l'UEFN (et non les fichiers de votre projet), vous allez créer un fichier .mcp.json.

Pour créer le fichier mcp.json : 

1. Dans le dossier racine de votre projet UEFN, faites un clic droit et créez un nouveau document texte. Nommez-le .mcp.txt.  

   

2. Ouvrez le document texte.

3. Copiez et collez le texte suivant dans le fichier. Ce JSON est propre au modèle et doit être mis en forme en fonction de l'agent d'IA que vous utilisez. L'exemple ci-dessous est le JSON de Claude :

   Config

   mcp.json
   {
     "mcpServers": {
       "unreal-mcp": {
         "type": "http",
         "url": "http://127.0.0.1:8000/mcp"
       }
     }
   }
   

   Copy full snippet(9 lines long)

4. Enregistrez-le sous Tous les fichiers et remplacez l'extension .txt par .json.

   

Une fois que vous avez créé votre configuration pour votre agent IA, il reste un point à prendre en compte si vous utilisez Codex CLI. La configuration TOML qu'il utilise n'est écrite qu'une seule fois, ce qui signifie que la commande ne remplace pas un fichier existant. Pour cette raison, toute configuration obsolète doit être supprimée manuellement. Pour la configuration au format JSON utilisée par Claude Code, Cursor, VS Code et Gemini, ces éléments sont fusionnés avec les entrées existantes, ce qui permet d'exécuter la commande à plusieurs reprises en toute sécurité. 

Connecter un agent IA

Pour connecter un agent IA à l'UEFN, lancez l'application ou l'interface de ligne de commande de votre agent IA préféré depuis la racine du projet ou de l'espace de travail où les fichiers de configuration .mcp.json ont été générés. Vous pouvez vous référer au journal de sortie lors de la génération du fichier de configuration pour cet emplacement de fichier. 

Voici un exemple de lancement de Claude depuis le dossier dans lequel le fichier .mcp.json a été créé : 

Si vous rencontrez des difficultés à vous connecter, essayez ce qui suit :

• Si l'interface en ligne de commande ou l'application de votre agent d'IA ne trouve pas Unreal MCP, vérifiez qu'elle a bien été lancée depuis la racine du projet ou de l'espace de travail où se trouvent les fichiers de configuration.

• Essayez un autre port si celui utilisé par défaut (8000) est utilisé par un autre service. Vous pouvez définir cela dans les préférences de l'éditeur avec le numéro de port du serveur.

• Assurez-vous que l'éditeur de scripts Python et les trousses à outils UEFN MCP sont activés dans les paramètres du projet.

• Pour démarrer et arrêter le serveur, vous devez fermer et rouvrir l'éditeur. En cas de doute, essayez de redémarrer l'éditeur.

Avec quelles autres fonctionnalités Unreal MCP interagit-il ?

Suggestions de prompts pour les trousses à outils

Le tableau ci-dessous propose des prompts qui vous permettent de passer en revue les possibilités offertes par chaque fonctionnalité, tout en vérifiant que chaque trousse à outils fonctionne comme prévu. 

Conseils pour obtenir les meilleurs résultats

• Soyez précis dans la dénomination.

  • Lorsque vous rédigez un prompt, il est préférable d'être aussi précis que possible lorsque vous demandez à l'agent d'effectuer une action sur un objet. Par exemple, demander à l'agent de changer quelque chose avec « le chronomètre » plutôt qu'avec « cette chose que j'ai ajoutée » générera un meilleur résultat.

• Demandez aux agents de répertorier les outils disponibles.

  • Des outils de découverte sont prévus à cet effet et permettent de limiter les erreurs de supposition.

• Demandez un plan pour les requêtes en plusieurs étapes.

  • Passez en revue le plan fourni avant de demander à l'agent d'exécuter la tâche. Cela empêche l'agent de faire des suppositions incorrectes concernant votre demande.

• Veillez à ce que les modifications restent faciles à vérifier.

  • Les petites modifications sont plus simples à vérifier qu'un grand ensemble de modifications. Il peut devenir de plus en plus difficile de vérifier ce type de modifications et certaines peuvent passer inaperçues en cours de route.

Problèmes connus

Voici une liste des problèmes connus qui font actuellement l'objet d'investigations et qui pourraient être résolus dans une prochaine version :

• Conversion du système de coordonnées et des transformations du format LUF au format XYZ.

  • Actuellement, les trousses à outils Python utilisent le format XYZ au lieu du système de coordonnées Left-Up-Forward (LUF). Pour la conversion entre XYZ et LUF utilisée par l'UEFN, cela fonctionnera dans certains cas lorsque vous demanderez à un agent IA de s'en charger, mais parce que les systèmes fonctionnent différemment en ce qui concerne les calculs spatiaux, le risque d'erreur est plus élevé.

• Saccades dans l'éditeur

  • Les appels d'outils MCP peuvent entraîner des saccades et des plantages de l'éditeur. Nous étudions actuellement des moyens de rendre les appels d'outils plus efficaces dans l'éditeur.