Godot MCP

Derivado de Coding-Solo/godot-mcp en el commit 1209744 (MIT). Esta bifurcación se mantiene de forma independiente por @jamesdowzard y añade soporte para el validador de exportación de Android + otras herramientas compatibles con IA. La relación de bifurcación con el original se ha cortado a nivel de git; los derechos de autor/atribución se conservan según la licencia MIT.

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


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

Un servidor del Protocolo de Contexto de Modelo (MCP) para interactuar con el motor de juegos Godot.

Introducción

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

Características

• Iniciar el editor de Godot: Abrir el editor de Godot para un proyecto específico

• Ejecutar proyectos de Godot: Ejecutar proyectos de Godot en modo de depuración

• Capturar la salida de depuración: Recuperar la salida de la consola y los mensajes de error

• Controlar la ejecución: Iniciar y detener proyectos de Godot mediante programación

• Obtener la versión de Godot: Recuperar la versión instalada de Godot

• Listar proyectos de Godot: Encontrar proyectos de Godot en un directorio especificado

• Análisis de proyectos: Obtener información detallada sobre la estructura del proyecto

• 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 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 el UID para archivos específicos

  • Actualizar referencias de UID volviendo a guardar los recursos

Requisitos

• Godot Engine instalado en su sistema

• Node.js (>=18.0.0) y npm

• Un agente de IA que soporte MCP

Inicio rápido

Claude Code

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

Eso es todo. Reinicie Claude Code y sus herramientas de 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

Añada esto a su archivo de configuración de MCP de Cline (~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json):

{
  "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"
      ]
    }
  }
}

Usando la interfaz de usuario de Cursor:

1. Vaya a Cursor Settings > Features > MCP

2. Haga clic en el botón + Add New MCP Server

3. Rellene el formulario:

   • Name: godot

   • Type: command

   • Command: npx @coding-solo/godot-mcp

4. Haga clic en "Add"

5. Es posible que deba presionar el botón de actualizar en la esquina superior derecha de la tarjeta del servidor MCP para poblar la lista de herramientas

Usando la configuración específica del proyecto:

Cree un archivo en .cursor/mcp.json en el directorio de su proyecto:

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

Para cualquier cliente compatible con MCP, utilice esta configuración:

{
  "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

Luego apunte su cliente MCP a build/index.js en lugar de usar npx.

Arquitectura

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

1. Comandos directos: Las operaciones simples como iniciar el editor u obtener información del proyecto utilizan directamente los comandos CLI integrados de Godot.

2. Script de operaciones incluidas: Las operaciones complejas como crear escenas o añadir 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 una ejecución de operaciones flexible y dinámica 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 no vá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

• Asegúrese de que el servidor MCP aparezca y esté habilitado en la configuración de Cursor (Settings > MCP)

• Las herramientas MCP solo se pueden ejecutar usando el perfil de chat del Agente (suscripción Cursor Pro o Business)

• Use el "Modo Yolo" para ejecutar automáticamente las solicitudes de herramientas MCP

Licencia

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