Godot Native MCP (SSE)

Godot MCP (Server-Sent Events) - Conector para Cursor, Claude y Windsurf

Inglés | 中文

Una integración de servidor Model Context Protocol (MCP) lista para usar, sin dependencias, diseñada específicamente para Godot Engine (4.x).

📢 Aviso sobre migración de organización y confianza

Este repositorio (vberai/godot-mcp) es el hogar organizacional oficial del popular plugin godot-mcp, creado originalmente por nuestro cofundador y desarrollador principal @DaxianLee (Repositorio original: DaxianLee/godot-mcp, confiable con más de 460 estrellas y 50 forks).

Hemos migrado el desarrollo activo aquí bajo la marca VberAI para garantizar mantenimiento a largo plazo, mejoras continuas de funciones (como asistentes de configuración con un clic para múltiples IDEs) e integraciones más profundas con el motor. ¡Es y siempre será 100% gratuito y de código abierto!

---

✨ Configuración sin dependencias y con GUI integrada

La mayoría de los plugins MCP te obligan a instalar Node.js/NPM, compilar archivos TS y configurar enrutadores de terminal. godot-mcp funciona de manera diferente:

• Sin fricción de CLI: Se ejecuta completamente dentro de tu editor de Godot mediante un servidor HTTP integrado y ligero.
• Configuración de IDE con un clic: Incluye un panel de acoplamiento en el editor que puede escribir instantáneamente archivos de configuración para Cursor o Trae con un solo clic, o copiar las cadenas de configuración de instalación CLI exactas para Claude Desktop / Claude Code.
• Centro de control visual: Cambia herramientas, monitorea los registros en vivo del servidor local y controla los puertos de conexión (Predeterminado: 3000) directamente en la interfaz de usuario de Godot.

┌────────────────────────────────────────────────────────┐
│ [ Godot Editor Panel ]                                 │
│ ┌───────────────┐ ┌────────────────┐ ┌───────────────┐ │
│ │  Server Logs  │ │  Tools Status  │ │  Config (IDE) │ │
│ ├───────────────┴ └────────────────┴ ───────────────┤ │
│ │  Host IP: 127.0.0.1      [Start Server] [Stop]     │ │
│ │  Selected IDE: [ Cursor / Trae / Claude Desktop ] │ │
│ │  >> [ONE-CLICK CONFIG] <<                          │ │
│ └────────────────────────────────────────────────────┘ │
└────────────────────────────────────────────────────────┘

---

🧰 Herramientas MCP compatibles (Registro de API)

Una vez conectados, tus agentes de IA (Claude, Cursor, Trae, ChatGPT) obtienen acceso a un potente conjunto de herramientas para interactuar con el directorio activo de tu proyecto Godot. El servidor expone las siguientes funciones:

📁 Gestión de espacio de trabajo y escenas

• scene_create(path, root_node_type): Genera un recurso de escena .tscn nuevo programáticamente.
• scene_open(path): Abre, empareja y enfoca automáticamente el viewport en una escena objetivo en el editor.
• scene_save(): Activa un evento de guardado en vivo de la escena de trabajo actual.
• get_scene_tree(path): Expone la estructura completa del árbol de nodos analizado de una escena objetivo al contexto del LLM.
• get_scene_info(path): Devuelve metadatos, dependencias externas (recursos) y detalles del inspector de una escena.

📝 Refactorización y edición de scripts

• read_gdscript(path): Carga de forma segura cualquier archivo .gd en la ventana de la IA para su inspección.
• write_gdscript(path, code): Escribe o modifica código GDScript completo, totalmente compatible con autoformato y validación de sintaxis.
• modify_gdscript(path, modifications): Añade, reemplaza o estructura bloques específicos de un GDScript activo sin reescribir todo el archivo.

⚙️ Estado y ejecución del motor

• get_godot_state(): Obtiene el contexto global del editor, estructuras de ventanas, nodos seleccionados y opciones de compilación activas.
• execute_editor_command(command): Permite al agente instruir al sistema padre para compilar archivos del proyecto, compilar recursos o ejecutar/detener la escena de juego activa.

---

🎬 Demostración

---

⚡ Inicio rápido (configuración en 60 segundos)

1. Habilita el complemento de Godot

1. Copia la carpeta addons/godot_mcp en el directorio res://addons/ de tu proyecto Godot.
2. En Godot, ve a Proyecto -> Configuración del proyecto -> Plugins y marca la casilla Habilitar para Godot MCP Server.

2. Inicia el servidor MCP

1. Abre el panel GodotMCP en el dock del editor.
2. Haz clic en Iniciar servidor y confirma que el servidor se está ejecutando en el puerto 3000.

3. Configura en vivo tu cliente favorito

Opción A: Cursor / Trae (Configuración dinámica desde el panel integrado)

1. Localiza el panel GodotMCP en los docks de tu editor (generalmente abajo a la derecha o en el panel derecho).
2. Ve a la pestaña Config.
3. Haz clic en Config con un clic. El plugin localizará tus archivos de configuración del IDE local y registrará el bloque del servidor al instante.

Opción B: Configuración de Claude Desktop

Copia la configuración a continuación en tu claude_desktop_config.json manualmente si lo deseas:

{
  "mcpServers": {
    "godot-mcp": {
      "command": "curl",
      "args": ["-s", "http://127.0.0.1:3000/mcp"],
      "transport": "http"
    }
  }
}

---

🌐 El ecosistema VberAI

Aunque Godot MCP es 100% gratuito y de código abierto bajo la licencia MIT, nos especializamos en construir entornos profesionales de diseño de juegos nativos de IA. Si estás desarrollando en otras plataformas o necesitas espacios de trabajo automatizados de nivel empresarial, explora nuestros motores personalizados de grado profesional:

Motor / Suite	Producto	Licencia / Edición	Detalles y tienda
Godot Engine	Godot MCP	🟢 Código abierto (MIT)	Gratis para siempre, flujo de trabajo impulsado por la comunidad
Unity Engine	Unity MCP Pro	🟡 Comercial	Enrutamiento de memoria personalizado, enlaces de agentes especializados
Cocos Creator	Cocos MCP Pro	🟡 Comercial	Optimizaciones para Web, H5 y minijuegos de WeChat
VberAI Studio	VberAI Studio (SaaS)	💎 Suscripción	Estudio completo nativo de agentes que gestiona activos y diseño

Obtén más información y comienza tus pruebas gratuitas en vberai.com.

---

🤝 Soporte y desarrollo

¡Animamos encarecidamente a la comunidad a reportar errores y enviar solicitudes de extracción (pull requests)!

• Si encuentras un problema o deseas sugerir nuevas herramientas de la API de Godot, abre un Issue.
• Para consultas corporativas y licencias sobre productos Cocos/Unity, escríbenos a: info [at] vberai.com.

---

📄 Licencia

Este repositorio está licenciado bajo la Licencia MIT; consulta el archivo LICENSE para más detalles.