🏆 Godot MCP Server Ultimate Edition (63+ Herramientas Profesionales)

<div align="center"> <img src="https://godotengine.org/assets/press/logo_large_monochrome_dark.png" alt="Godot Engine" width="300" /> </div>

<br/>

El servidor Model Context Protocol (MCP) más avanzado, robusto y profesional del mundo para Godot 4.6+

Este no es un servidor MCP cualquiera que edita archivos a ciegas. Se trata de un Backend de Asistencia de IA de Nivel Empresarial construido para interactuar con Godot Engine igual que lo haría un Programador Senior. Evita por completo los errores comunes del código generado por IA utilizando integraciones profundas con el motor, estados de reversión (rollback) y diagnósticos activos de la salud del proyecto.

---

🌟 ¿Por qué este MCP es infinitamente superior?

La mayoría de los servidores MCP de Godot te obligan a instalar plugins internos inestables o realizan ediciones de archivos "a ciegas" desde la terminal. Este repositorio trasciende esas limitaciones implementando una Arquitectura de Cero Compromisos:

1. 🛡️ Operaciones Transaccionales (Backup & Rollback)

Las IAs alucinan. Si la IA rompe un archivo .tscn, normalmente tu escena se pierde para siempre. Aquí no. Este MCP implementa de forma obligatoria el patrón de Copia de Seguridad Antes de Mutar:

• backup_scene: Crea instantáneamente un estado de tu escena con marca de tiempo dentro de la carpeta oculta .scene_backups/, protegido por rastreo avanzado .meta.json.
• restore_scene_backup: Revierte el archivo automáticamente si la operación de la IA corrompe el árbol de nodos.
• Una red de seguridad que garantiza que ninguna acción de la IA destruirá tu trabajo de forma permanente.

2. 🧠 Validación Profunda Nativa (validate_script_deep)

Otros MCPs solo validan la sintaxis usando herramientas básicas. Este MCP arranca un compilador Headless de Godot en segundo plano para validar tu código GDScript de manera real.

• Detecta errores semánticos, referencias perdidas a class_name y violaciones restrictivas de tipado estático antes de adjuntar el script a cualquier nodo.
• Lee los errores nativos directamente del sistema interno de Godot y le indica a la IA la línea exacta del fallo.

3. 🏥 Diagnóstico Activo del Proyecto (project_health_check)

La IA no espera a que el juego falle para actuar. Ejecuta un escáner pesado que revisa todo tu proyecto detectando deuda técnica:

• 🔴 Dependencias rotas y escenas que no se pueden cargar.
• 🟡 Nodos de Física (PhysicsBody) a los que se les ha olvidado poner colisiones (CollisionShape).
• 🔗 Referencias internas rotas o UIDs huérfanos (crucial para Godot 4.4+).
• Retorna un informe estructurado a la IA para que ataque y solucione todos los problemas de raíz.

4. 🚀 Cero Intrusión en tu Juego

Se acabaron los tiempos de instalar plugins o ensuciar tu carpeta addons/. Este MCP funciona de manera completamente externa usando godot --headless, leyendo e inyectando código en carpetas ocultas (.godot/mcp_temp) dejando todo el código fuente de tu juego intacto y limpio.

---

🛠️ Un Arsenal de 63 Herramientas

Nuestro MCP provee a la IA con 63 herramientas especializadas para desarrollar videojuegos masivamente más rápido:

• Arquitectura de Proyecto: Configurar resoluciones, Renderer, instalar Autoloads, mapeo de controles InputMap, escenas principales y control del WorldEnvironment.
• Manipulación de Nodos: Crear, borrar, mover, duplicar y añadir cientos de nodos por lotes de forma instantánea.
• Edición de Propiedades: Sistema inteligente para encontrar grupos específicos de nodos a través de múltiples escenas y cambiar propiedades en masa usando RegEx.
• Manejo de Señales y Recursos: Conectar señales (signals), empaquetar agrupaciones lógicas, cargar e instanciar sprites, medir hitboxes 3D, y transformar bibliotecas (MeshLibrary) completas para escenarios.
• Sistemas Nativos: Autocreación de UI, preset impresionantes de partículas GPU (fuego, nieve, lluvia, chispas), configuración técnica de audios en espacio 3D e instanciación de controladores de luz omnidireccionales y globales.
• Debugging Realtime: La IA arranca el juego directamente para el usuario, lee los logs, intercepta crashes por la consola nativa (get_debug_output()) y te corrige el error casi sin intervención humana.

---

💻 Inicio Rápido y Setup

Requisitos Previos

• Node.js (v18+)
• Godot 4.6.2+ (Funciona desde 4.4, pero está fuertemente optimizado para las últimas mejoras)
• Un Cliente IA que soporte integraciones MCP (Claude Desktop, Cline, Trae, Antigravity)

Instalación Inmediata

1. Clona este repositorio:

   git clone https://github.com/Dex865378/MCP-GODOT-63-HERRAMIENTAS.git
   cd MCP-GODOT-63-HERRAMIENTAS
   

2. Instala y Compila:

   npm install
   npm run build
   

3. Configura tu Asistente de IA (Claude/Cline): Edita la configuración de tu entorno de MCP (por ejemplo claude_desktop_config.json) apuntando hacia el servidor construido en la carpeta build:

   {
     "mcpServers": {
       "godot": {
         "command": "node",
         "args": ["/ruta/absoluta/a/MCP-GODOT-63-HERRAMIENTAS/build/index.js"]
       }
     }
   }
   

   Dato Clave: Si agregas en este archivo la variable de entorno GODOT_PATH apuntando directamente a tu .exe de Godot, el servidor correrá instantáneamente con su máximo rendimiento.

---

👾 Probando el Poder del MCP

Una vez conectado, puedes pedirle cosas inmensas a la IA, por ejemplo:

"Créame un jugador para un juego plataformero 2D desde cero. Usa la textura player_sprite.png, métele las colisiones correspondientes, programa toda la física incluyendo código sólido con move_and_slide() y valídalo de manera profunda para asegurarnos que está perfecto. Por último conectalo con el control space del teclado."

La IA se encargará por sí sola de instanciar los nodos, enganchar las clases de físicas, validar el código sin errores por compilador nativo de godot, y programar los teclados, permitiéndote dirigir la creación de tu propio videojuego a la velocidad del pensamiento.

---

🤖 Bonus Opcional: El Agente Experto Universal (godot_expert.md)

Dentro de este repositorio encontrarás el archivo godot_expert.md. El uso de este archivo es opcional, pero altamente recomendado si buscas el nivel más extremo de eficiencia en tu asistente.

Este documento funciona como el "Cerebro Lógico" de un desarrollador Senior. Al adjuntarlo o copiarlo dentro del Prompt del Sistema de tu asistente de IA, obtendrás:

• Instrucciones absolutas, patrones y metodologías probadas para la creación de juegos en 2D, 2.5D (Isométrico Auténtico) y 3D.
• Patrones arquitectónicos de código base estandarizados y sistemas pre-armados (Sistema de Guardado, Gestores de Sonido y Manejadores Globales).
• Evita que la IA deba deducir cómo plantear las lógicas desde cero. La IA ya sabrá qué y cómo estructurar tus juegos.

Úsalo en conjunto con este MCP y observarás cómo el desempeño y capacidad técnica de la IA se eleva a niveles casi imposibles.

---

📜 Licencia y Uso Libre (Atribución Obligatoria)

Este proyecto es 100% de uso libre y Open Source para todo el mundo. Tienes la libertad total de usarlo, modificarlo y adaptarlo a tus necesidades sin ningún tipo de límite.

Sin embargo, tiene una única condición irrenunciable: Atribución y Crédito. Si decides forkear, clonar, o utilizar el código (o partes significativas) de este MCP dentro de otro repositorio, aplicación o sistema público, estás obligado por licencia a nombrar e incluir a "Dex865378" en los créditos/contribuidores del proyecto final, como el autor y credor de esta Base Avanzada (Utimate Edition).

---

<p align="center"> <b>Creado de principio a fin para los desarrolladores que exigen cero tolerancia al fallo.</b><br/> <i>Por Dex865378.</i> </p>