Godot MCP

Qu'est-ce que Godot MCP ?

Godot MCP est un plugin pour le moteur Godot qui agit comme un pont entre vos projets Godot et les assistants AI en utilisant le protocole standardisé Model Context. Il permet aux outils AI d'accéder, d'analyser et de modifier des scripts, des scènes, des nœuds et des paramètres de projet directement. Cela ouvre de nouveaux flux de travail pour le développement, le débogage et la collaboration créative basés sur l'IA.

Comment configurer Godot MCP

• Clonez le dépôt godot-mcp et naviguez jusqu'à son répertoire.
• Construisez et configurez le serveur MCP en exécutant npm install et npm run build dans le répertoire /server.
• Modifiez votre fichier de configuration de Claude Desktop (ex. : claude_desktop_config.json) pour ajouter une entrée serveur MCP pointant vers le fichier d'entrée de votre serveur construit.
• Assurez-vous de remplacer PATH_TO_YOUR_PROJECT par le chemin absolu de votre dépôt cloné.
• Redémarrez Claude Desktop pour appliquer les modifications.
• Dans Godot, ouvrez le projet exemple fourni ou ajoutez le dossier addons/godot_mcp au répertoire d'addons de votre propre projet.
• Activez le plugin depuis Projet > Paramètres du Projet > Plugins dans l'éditeur Godot.

Comment utiliser Godot MCP

Avec le serveur MCP en cours d'exécution et le plugin activé, interagissez avec votre projet Godot depuis l'interface de l'assistant AI (ex. : Claude Desktop) en utilisant des invites structurées ou en langage naturel. Préfixez les commandes avec @mcp godot-mcp pour envoyer des requêtes via le serveur MCP. Vous pouvez demander des suggestions de code, des changements de scène, du contenu généré par l'IA et exécuter des commandes de projet ou de ressource directement.

Exemples d'invites

• @mcp godot-mcp read godot://script/current
  "J'ai besoin d'aide pour optimiser mon code de mouvement de joueur. Pouvez-vous suggérer des améliorations ?"
• @mcp godot-mcp run get-scene-tree
  "Ajoutez un cube au milieu de la scène, puis créez une caméra qui regarde le cube."
• @mcp godot-mcp read godot://scene/current
  "Créez une IA ennemie qui patrouille entre des points de passage et attaque le joueur quand il est à portée."

Caractéristiques clés

• Communication bidirectionnelle fluide entre Godot et les assistants AI
• Accès et modification programmatique des ressources de projet, scripts, scènes et nœuds
• Ensemble de commandes étendu pour la gestion des nœuds, l'édition des scripts, le contrôle des scènes et des projets
• Facilement extensible avec des points de terminaison d'outils MCP supplémentaires
• Configuration sécurisée, locale ou à distance, avec support pour l'intégration via Claude Desktop
• Assistance en langage naturel pilotée par l'IA pour la programmation, le débogage et la création de scènes

Cas d'utilisation

• Révision, génération et refactoring de code pilotés par l'IA pour des fichiers GDScript
• Création automatique de scènes, gestion des nœuds et génération d'environnements procéduraux
• Analyse à l'échelle du projet pour l'optimisation des performances ou la détection des erreurs
• Mise en œuvre de la logique de jeu, des comportements AI et des éléments d'interface utilisateur via les suggestions de l'IA
• Édition en masse ou création de ressources et de paramètres par le biais de l'orientation AI
• Accélération du prototypage, de l'apprentissage ou du développement collaboratif dans les projets Godot

FAQ

Q : Le plugin ne fonctionne pas ou n'apparaît pas dans Godot. Que dois-je faire ?
R : Assurez-vous d'avoir activé le plugin "Godot MCP" dans Projet > Paramètres du Projet > Plugins. Si vous avez récemment copié l'addon ou fait des modifications de configuration, essayez de recharger le projet et vérifiez les messages d'erreur dans la console Godot.

Q : Claude Desktop ne peut pas se connecter au serveur MCP. Quel est le problème ?
R : Vérifiez que le serveur fonctionne correctement (pas d'erreurs au démarrage) et que votre configuration Claude Desktop a le bon chemin absolu. Assurez-vous que MCP_TRANSPORT est défini sur stdio. Redémarrez Claude Desktop après avoir mis à jour la configuration.

Q : Puis-je utiliser Godot MCP avec mes projets existants, ou seulement l'exemple inclus ?
R : Oui, vous pouvez l'utiliser avec n'importe quel projet Godot. Il suffit de copier le dossier addons/godot_mcp dans le répertoire d'addons de votre projet et d'activer le plugin depuis les paramètres.

Q : Que faire si je veux étendre Godot MCP ou ajouter des commandes personnalisées ?
R : Le plugin et le serveur sont open-source et conçus pour l'extensibilité. Vous pouvez implémenter de nouveaux points de terminaison dans le serveur MCP ou étendre l'addon Godot pour exposer des fonctionnalités supplémentaires.

Q : Les données de mon projet sont-elles sécurisées lorsque j'utilise Godot MCP ?
R : Oui, par défaut, le serveur MCP s'exécute sur votre machine locale et n'accède qu'aux fichiers et données que vous autorisez. Vérifiez les configurations du serveur et gardez toujours à l'esprit les meilleures pratiques pour la sécurité des données.