Un servidor MCP para interactuar con el motor de juegos Godot. Proporciona herramientas para iniciar el editor, ejecutar proyectos y capturar la salida de depuración.

📚 Introducción al Proyecto Godot MCP

I. Resumen del Proyecto

Godot MCP (Servidor de Protocolo de Contexto del Modelo) publicado por Coding‑Solo, es una herramienta que sirve de puente entre los asistentes de IA y el motor Godot. A través del protocolo MCP, puede iniciar el editor de Godot, ejecutar proyectos, capturar información de depuración y ejercer un control profundo sobre la estructura del proyecto y las escenas.

Este mecanismo proporciona un bucle de retroalimentación real a los asistentes de IA (como Claude, Cline, Cursor), permitiéndoles operar proyectos de manera práctica, depurar problemas y generar código GDScript de alta calidad.

---

II. Funciones y Características Principales

1. Iniciar el Editor y Ejecutar Proyectos Soporte a través de la línea de comandos para:

   • Iniciar el editor de Godot en la ruta especificada.
   • Ejecutar el proyecto en modo de depuración.
   • Capturar y devolver la salida de la consola o los mensajes de error.

2. Obtención y Análisis de la Estructura del Proyecto

   • Obtener la versión del proyecto, la estructura de directorios y la lista de recursos.
   • Profundizar en la información de la estructura de la escena, incluyendo el árbol de nodos, las propiedades, las rutas de los recursos, etc.

3. Gestión de Escenas y Nodos

   • Crear nuevas escenas (especificando el tipo de nodo raíz).
   • Añadir nodos a escenas existentes y establecer propiedades.
   • Cargar texturas Sprite2D, exportar MeshLibrary para GridMap.
   • Guardar escenas y soportar la generación de variantes de escenas.

4. Depuración y Gestión de Versiones

   • Detener el proyecto en ejecución.
   • Obtener y mostrar la versión del motor Godot.
   • (Aplicable a Godot 4.4+) Obtener el UID del archivo y actualizar las referencias de los recursos.

5. Compatibilidad con Diversas Herramientas de Asistencia de IA

   • Soporte para Cline y Cursor: Integración de herramientas de asistencia de IA a través de archivos de configuración MCP y la línea de comandos.

---

III. Arquitectura y Aspectos Destacados de la Implementación

• "Script de Operaciones" Único en GDScript Todos los comandos complejos (como la creación de nodos, la exportación de escenas, etc.) son gestionados por un único archivo godot_operations.gd, evitando la generación de scripts temporales individuales, garantizando la simplicidad y la eficiencia, y reduciendo las posibles E/S de disco y los errores.

• Mecanismo Combinado de CLI y Script Los comandos simples se ejecutan directamente a través de la CLI de Godot, mientras que las operaciones complejas se realizan a través de scripts GDScript. Ambos utilizan el protocolo MCP para transmitir instrucciones JSON, lo que proporciona una estructura unificada y fácil de ampliar.

• Estructura de Respuesta Estandarizada Todas las operaciones devuelven un formato unificado: estado, contenido del resultado, salida estándar/error, lo que facilita el análisis, el aprendizaje y la generación automática de sugerencias de cambio por parte de la IA.

---

IV. Flujo de Uso

1. Instalación y Construcción

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

2. Configuración de Herramientas de IA

   • Cline: Añadir la configuración del servidor correspondiente en cline_mcp_settings.json.
   • Cursor: Añadir la instrucción node a través de Settings → Features → MCP.

3. Ejecución e Interacción

   • Ejemplos de instrucciones de IA:

     • launch_editor: Iniciar el editor.
     • run_project: Ejecutar el proyecto y obtener la salida.
     • create_scene / add_node: Crear escena/nodo.
     • get_debug_output / stop_project: Instrucciones de control de depuración.
     • get_uid / update_project_uids: Gestión de UID.

---

V. Resumen de los Aspectos Destacados del Proyecto

Ventaja	Descripción
🌟 Alta Automatización	El asistente de IA controla directamente el editor/proyecto, sin necesidad de intervención manual.
🚫 Sin Archivos Temporales	Utiliza una única entrada GDScript, ligera y eficiente.
♻️ Soporte de Versiones y UID	Compatible con las características de Godot 4.4+, puede gestionar los UID de los recursos.
🛠️ Fácil de Ampliar e Integrar	El estándar MCP facilita la adición de nuevas funciones y es compatible con múltiples herramientas de IA.

---

VI. Conclusión 🌈

Godot MCP es una herramienta potente y práctica que tiende un puente entre los asistentes de IA y el motor Godot. La IA puede directamente:

• Iniciar el editor, ejecutar proyectos, recopilar datos.
• Acceder a la estructura del proyecto, scripts, escenas, recursos.
• Modificar dinámicamente escenas, nodos, scripts.
• Realizar depuración, generar sugerencias de código GDScript.

Gracias a un protocolo unificado y un script de operaciones GDScript, proporciona una interfaz de automatización clara, estándar y extensible, lo que la convierte en una herramienta valiosa para los desarrolladores de juegos para mejorar la eficiencia y los flujos de trabajo de desarrollo inteligentes.