# 🏆 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:**
   ```bash
   git clone https://github.com/Dex865378/MCP-GODOT-63-HERRAMIENTAS.git
   cd MCP-GODOT-63-HERRAMIENTAS
   ```

2. **Instala y Compila:**
   ```bash
   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`:
   ```json
   {
     "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>