godot-mcp

Godot MCP est un serveur Model Context Protocol (MCP) qui fait le pont entre les agents IA et le moteur de jeu Godot. Il permet aux assistants IA d'interagir directement avec les projets Godot en lançant l'éditeur, en exécutant des projets en mode débogage, en capturant la sortie de la console et en contrôlant le flux d'exécution. Le serveur offre également des fonctionnalités de gestion de scènes, notamment la création de scènes, l'ajout de nœuds avec des propriétés personnalisées, le chargement de sprites, l'exportation de scènes 3D en ressources MeshLibrary et la gestion des références UID pour Godot 4.4+. ## Fonctionnalités principales - **Contrôle de l'éditeur et des projets** : Lancer l'éditeur Godot, exécuter des projets en mode débogage et les arrêter par programmation - **Capture de la sortie de débogage** : Récupérer la sortie de la console et les messages d'erreur pour un retour en temps réel - **Analyse de projet** : Lister les projets d'un répertoire, obtenir des informations détaillées sur la structure du projet et récupérer la version de Godot installée - **Gestion des scènes** : - Créer de nouvelles scènes avec des types de nœuds racines spécifiés - Ajouter des nœuds aux scènes existantes avec des propriétés personnalisables - Charger des sprites/textures dans des nœuds Sprite2D - Exporter des scènes 3D en ressources MeshLibrary pour GridMap - Enregistrer des scènes avec des options de variantes - **Gestion des UID** (Godot 4.4+) : Obtenir les UID des fichiers et mettre à jour les références UID en réenregistrant les ressources ## Architecture Le serveur utilise une approche hybride : 1. **Commandes directes** : Les opérations simples (lancement de l'éditeur, obtention de la version) utilisent les commandes CLI intégrées de Godot 2. **Script d'opérations intégré** : Les opérations complexes (création de scènes, manipulation de nœuds) utilisent un fichier GDScript complet unique (`godot_operations.gd`) qui accepte le type d'opération et les paramètres au format JSON, permettant une exécution flexible sans générer de fichiers temporaires ## Prérequis - Moteur Godot installé - Node.js (>=18.0.0) et npm - Un agent IA compatible MCP (par ex. Claude Code, Cursor) ## Démarrage rapide Pour Claude Code : claude mcp add godot -- npx @coding-solo/godot-mcp Pour Cursor, ajoutez le serveur MCP dans les paramètres avec la commande `npx @coding-solo/godot-mcp`. ## Configuration Variables d'environnement : - `GODOT_PATH` : Chemin de l'exécutable Godot (remplace la détection automatique) - `DEBUG` : Définir sur "true" pour une journalisation détaillée côté serveur ## Dépannage - **Godot introuvable** : Définir la variable d'environnement `GODOT_PATH` - **Problèmes de connexion** : S'assurer que le serveur est en cours d'exécution et redémarrer votre assistant IA - **Chemin de projet invalide** : S'assurer que le chemin contient un fichier `project.godot` - **Problèmes de build** : Exécuter `npm install` pour installer les dépendances ## Licence Licence MIT