Serveur MCP pour interagir avec le moteur de jeu Godot. Fournit des outils pour lancer l'éditeur, exécuter des projets et capturer la sortie de débogage.

📚 Présentation du Projet Godot MCP

I. Aperçu du Projet

Godot MCP (Serveur Model Context Protocol) est un outil publié par Coding‑Solo qui sert de pont entre les assistants IA et le moteur Godot. Grâce au protocole MCP, il peut démarrer l'éditeur Godot, exécuter des projets, capturer des informations de débogage et exercer un contrôle approfondi sur la structure et les scènes du projet.

Ce mécanisme fournit aux assistants IA (tels que Claude, Cline, Cursor) une boucle de rétroaction réelle, leur permettant d'interagir concrètement avec les projets, de déboguer les problèmes et de générer du code GDScript de haute qualité.

---

II. Fonctionnalités et Caractéristiques Principales

1. Démarrage de l'éditeur et Exécution du Projet Prise en charge via la ligne de commande pour :

   • Démarrer l'éditeur Godot pour un chemin spécifié
   • Exécuter le projet en mode débogage
   • Capturer et renvoyer la sortie de la console ou les messages d'erreur

2. Acquisition et Analyse de la Structure du Projet

   • Obtenir la version du projet, la structure des répertoires et la liste des ressources
   • Approfondir les informations sur la structure des scènes, y compris l'arborescence des nœuds, les propriétés, les chemins d'accès aux ressources, etc.

3. Gestion des Scènes et des Nœuds

   • Créer de nouvelles scènes (en spécifiant le type de nœud racine)
   • Ajouter des nœuds aux scènes existantes et définir leurs propriétés
   • Charger des textures Sprite2D, exporter des MeshLibrary pour GridMap
   • Enregistrer les scènes et prendre en charge la génération de variantes de scènes

4. Débogage et Gestion des Versions

   • Arrêter le projet en cours d'exécution
   • Obtenir et afficher la version du moteur Godot
   • (Applicable à Godot 4.4+) Obtenir l'UID des fichiers et mettre à jour les références aux ressources

5. Compatibilité avec Divers Outils d'Assistance IA

   • Prise en charge de Cline et Cursor : intégration des outils d'assistance IA via les fichiers de configuration MCP et la ligne de commande

---

III. Architecture et Points Forts de l'Implémentation

• Un Seul "Script d'Opérations" GDScript Toutes les commandes complexes (telles que la création de nœuds, l'exportation de scènes, etc.) sont gérées par un seul fichier godot_operations.gd, évitant la génération de scripts temporaires individuels, garantissant ainsi la simplicité et l'efficacité, et réduisant les E/S disque et les risques d'erreurs.

• Mécanisme Combinant CLI et Script Les commandes simples sont exécutées directement via la CLI Godot, tandis que les opérations complexes sont gérées par des scripts GDScript. Les deux utilisent le protocole MCP pour transmettre des instructions JSON standardisées, offrant une structure uniforme et une extensibilité facile.

• Structure de Réponse Standardisée Toutes les opérations renvoient un format uniforme : état, contenu du résultat, sortie standard/erreur, ce qui facilite l'analyse, l'apprentissage et la génération automatique de suggestions de modifications par l'IA.

---

IV. Flux d'Utilisation

1. Installation et Construction

   git clone https://github.com/Coding-Solo/godot-mcp.git
   cd godot-mcp
   npm install
   npm run build
   

2. Configuration des Outils d'IA

   • Cline : Ajouter la configuration du serveur correspondante dans cline_mcp_settings.json
   • Cursor : Ajouter la commande node via Settings → Features → MCP

3. Exécution et Interaction

   • Exemples de commandes IA :

     • launch_editor : Démarrer l'éditeur
     • run_project : Exécuter le projet et obtenir la sortie
     • create_scene / add_node : Créer une scène/un nœud
     • get_debug_output / stop_project : Commandes de contrôle du débogage
     • get_uid / update_project_uids : Gestion des UID

---

V. Résumé des Points Forts du Projet

Avantage	Description
🌟 Haute Automatisation	L'assistant IA contrôle directement l'éditeur/le projet, sans intervention manuelle
🚫 Pas de Fichiers Temporaires	Utilisation d'un point d'entrée GDScript unique, léger et efficace
♻️ Prise en Charge des Versions & UID	Compatible avec les fonctionnalités de Godot 4.4+, permet de gérer les UID des ressources
🛠️ Facile à Étendre & à Intégrer	Le standard MCP facilite l'ajout de nouvelles fonctionnalités et est compatible avec de nombreux outils d'IA

---

VI. Conclusion 🌈

Godot MCP est un outil puissant et pratique qui sert de pont entre les assistants IA et le moteur Godot. L'IA peut directement :

• Démarrer l'éditeur, exécuter des projets, collecter des données ;
• Accéder à la structure du projet, aux scripts, aux scènes, aux ressources ;
• Modifier dynamiquement les scènes, les nœuds, les scripts ;
• Effectuer des débogages, générer des suggestions de code GDScript.

Grâce à un protocole unifié et à un script d'opérations GDScript, il offre une interface d'automatisation claire, standard et extensible, ce qui en fait un outil précieux pour les développeurs de jeux afin d'améliorer l'efficacité et les processus de développement intelligents.