Godot MCP

Godot MCP

                           (((((((             (((((((
                        (((((((((((           (((((((((((
                        (((((((((((((       (((((((((((((
                        (((((((((((((((((((((((((((((((((
                        (((((((((((((((((((((((((((((((((
         (((((      (((((((((((((((((((((((((((((((((((((((((      (((((
       (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
     ((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
    ((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
      (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
        (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
         (((((((((((@@@@@@@(((((((((((((((((((((((((((@@@@@@@(((((((((((
         (((((((((@@@@,,,,,@@@(((((((((((((((((((((@@@,,,,,@@@@(((((((((
         ((((((((@@@,,,,,,,,,@@(((((((@@@@@(((((((@@,,,,,,,,,@@@((((((((
         ((((((((@@@,,,,,,,,,@@(((((((@@@@@(((((((@@,,,,,,,,,@@@((((((((
         (((((((((@@@,,,,,,,@@((((((((@@@@@((((((((@@,,,,,,,@@@(((((((((
         ((((((((((((@@@@@@(((((((((((@@@@@(((((((((((@@@@@@((((((((((((
         (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
         (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
         @@@@@@@@@@@@@((((((((((((@@@@@@@@@@@@@((((((((((((@@@@@@@@@@@@@
         ((((((((( @@@(((((((((((@@(((((((((((@@(((((((((((@@@ (((((((((
         (((((((((( @@((((((((((@@@(((((((((((@@@((((((((((@@ ((((((((((
          (((((((((((@@@@@@@@@@@@@@(((((((((((@@@@@@@@@@@@@@(((((((((((
           (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
              (((((((((((((((((((((((((((((((((((((((((((((((((((((
                 (((((((((((((((((((((((((((((((((((((((((((((((
                        (((((((((((((((((((((((((((((((((


                          /$$      /$$  /$$$$$$  /$$$$$$$
                         | $$$    /$$$ /$$__  $$| $$__  $$
                         | $$$$  /$$$$| $$  \__/| $$  \ $$
                         | $$ $$/$$ $$| $$      | $$$$$$$/
                         | $$  $$$| $$| $$      | $$____/
                         | $$\  $ | $$| $$    $$| $$
                         | $$ \/  | $$|  $$$$$$/| $$
                         |__/     |__/ \______/ |__/

Un servidor de Model Context Protocol (MCP) para interactuar con el motor de juego Godot.

Introducción

Godot MCP permite a los agentes de IA lanzar el editor de Godot, ejecutar proyectos, capturar la salida de depuración y controlar la ejecución de proyectos. Este bucle de retroalimentación directa ayuda a los agentes a comprender qué funciona y qué no en proyectos reales de Godot, lo que conduce a una mejor generación de código y asistencia de depuración.

Características

• Iniciar el editor de Godot: Abre el editor de Godot para un proyecto específico
• Ejecutar proyectos de Godot: Ejecuta proyectos de Godot en modo de depuración
• Capturar salida de depuración: Recupera la salida de consola y mensajes de error
• Controlar la ejecución: Inicia y detiene proyectos de Godot mediante programación
• Obtener la versión de Godot: Recupera la versión de Godot instalada
• Listar proyectos de Godot: Encuentra proyectos de Godot en un directorio específico
• Análisis de proyectos: Obtén información detallada sobre la estructura del proyecto
• Gestión de escenas:
  • Crear nuevas escenas con tipos de nodo raíz especificados
  • Agregar nodos a escenas existentes con propiedades personalizables
  • Cargar sprites y texturas en nodos Sprite2D
  • Exportar escenas 3D como recursos MeshLibrary para GridMap
  • Guardar escenas con opciones para crear variantes
• Gestión de UID (para Godot 4.4+):
  • Obtener UID para archivos específicos
  • Actualizar referencias de UID guardando de nuevo los recursos

Requisitos

• Godot Engine instalado en su sistema
• Node.js (>=18.0.0) y npm
• Un agente de IA que admita MCP

Inicio Rápido

Claude Code

claude mcp add godot -- npx @coding-solo/godot-mcp

Eso es todo. Reinicie Claude Code y sus herramientas Godot MCP estarán disponibles.

Con variables de entorno:

claude mcp add godot -e GODOT_PATH=/path/to/godot -e DEBUG=true -- npx @coding-solo/godot-mcp

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["@coding-solo/godot-mcp"],
      "env": {
        "DEBUG": "true"
      },
      "disabled": false,
      "autoApprove": [
        "launch_editor",
        "run_project",
        "get_debug_output",
        "stop_project",
        "get_godot_version",
        "list_projects",
        "get_project_info",
        "create_scene",
        "add_node",
        "load_sprite",
        "export_mesh_library",
        "save_scene",
        "get_uid",
        "update_project_uids"
      ]
    }
  }
}

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["@coding-solo/godot-mcp"],
      "env": {
        "DEBUG": "true"
      }
    }
  }
}

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["@coding-solo/godot-mcp"],
      "env": {
        "GODOT_PATH": "/path/to/godot",
        "DEBUG": "true"
      }
    }
  }
}

Variables de Entorno

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

Arquitectura

El servidor Godot MCP utiliza un enfoque GDScript incluido para operaciones complejas:

1. Comandos Directos: Operaciones simples como iniciar el editor u obtener información del proyecto utilizan directamente los comandos CLI integrados de Godot.
2. Script de Operaciones Incluido: Operaciones complejas como crear escenas o agregar nodos utilizan un único archivo GDScript completo (godot_operations.gd) que maneja todas las operaciones.

El script incluido acepta el tipo de operación y los parámetros como JSON, lo que permite la ejecución flexible y dinámica de operaciones sin generar archivos temporales para cada operación.

Solución de Problemas

• Godot no encontrado: Establezca la variable de entorno GODOT_PATH a la ruta de su ejecutable de Godot
• Problemas de conexión: Asegúrese de que el servidor esté ejecutándose y reinicie su asistente de IA
• Ruta de proyecto inválida: Asegúrese de que la ruta apunte a un directorio que contenga un archivo project.godot
• Problemas de compilación: Asegúrese de que todas las dependencias estén instaladas ejecutando npm install

Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulte el archivo LICENSE para más detalles.