godot-mcp

Godot MCP es un servidor de Protocolo de Contexto de Modelo (MCP) que conecta agentes de IA con el motor de juegos Godot. Permite que asistentes de IA interactúen directamente con proyectos de Godot lanzando el editor, ejecutando proyectos en modo de depuración, capturando salida de consola y controlando el flujo de ejecución. El servidor también proporciona capacidades de gestión de escenas, incluyendo creación de escenas, adición de nodos con propiedades personalizadas, carga de sprites, exportación de escenas 3D como recursos MeshLibrary y gestión de referencias UID para Godot 4.4+. ## Características Clave - **Control de Editor y Proyecto**: Lanzar el editor de Godot, ejecutar proyectos en modo de depuración y detenerlos programáticamente - **Captura de Salida de Depuración**: Recuperar salida de consola y mensajes de error para retroalimentación en tiempo real - **Análisis de Proyectos**: Listar proyectos en un directorio, obtener información detallada de la estructura del proyecto y recuperar la versión instalada de Godot - **Gestión de Escenas**: - Crear nuevas escenas con tipos de nodo raíz especificados - Añadir nodos a escenas existentes con propiedades personalizables - Cargar sprites/texturas en nodos Sprite2D - Exportar escenas 3D como recursos MeshLibrary para GridMap - Guardar escenas con opciones de variantes - **Gestión de UID** (Godot 4.4+): Obtener UIDs para archivos y actualizar referencias UID re-guardando recursos ## Arquitectura El servidor utiliza un enfoque híbrido: 1. **Comandos Directos**: Operaciones simples (lanzar editor, obtener versión) usan comandos CLI integrados de Godot 2. **Script de Operaciones Empaquetado**: Operaciones complejas (creación de escenas, manipulación de nodos) usan un único archivo GDScript completo (`godot_operations.gd`) que acepta tipo de operación y parámetros como JSON, permitiendo ejecución flexible sin generar archivos temporales ## Requisitos - Motor Godot instalado - Node.js (>=18.0.0) y npm - Un agente de IA compatible con MCP (por ejemplo, Claude Code, Cursor) ## Inicio Rápido Para Claude Code: ```bash claude mcp add godot -- npx @coding-solo/godot-mcp ``` Para Cursor, añade el servidor MCP en la configuración con el comando `npx @coding-solo/godot-mcp`. ## Configuración Variables de entorno: - `GODOT_PATH`: Ruta al ejecutable de Godot (anula la detección automática) - `DEBUG`: Establecer en `"true"` para registro detallado del lado del servidor ## Solución de Problemas - **Godot No Encontrado**: Establecer la variable de entorno `GODOT_PATH` - **Problemas de Conexión**: Asegurarse de que el servidor esté ejecutándose y reiniciar el asistente de IA - **Ruta de Proyecto Inválida**: Asegurarse de que la ruta contenga un archivo `project.godot` - **Problemas de Compilación**: Ejecutar `npm install` para instalar dependencias ## Licencia Licencia MIT