Gear

Gear permite a los asistentes de IA ejecutar, inspeccionar, modificar y depurar directamente tus proyectos de Godot.

Inicio rápido (3 minutos)

Requisitos del entorno

• Godot 4.x

• Node.js 18+

• Cliente compatible con MCP (Claude Desktop, Cursor, Cline, etc.)

1) Iniciar Gear

npx -y gear

O instalación global:

npm install -g gear-godot-mcp
gear

2) Configurar el cliente MCP

Añade lo siguiente al archivo de configuración de tu cliente, como Claude Desktop:

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["-y", "gear"],
      "env": {
        "GODOT_PATH": "/path/to/godot"
      }
    }
  }
}

3) Prueba estos comandos

• "Lista todos los proyectos de Godot en el directorio /your/projects"

• "Crea scenes/Player.tscn con CharacterBody2D como nodo raíz"

• "Ejecuta el proyecto, obtén la salida de depuración y luego corrige los errores"

Related MCP server: Godot MCP Enhanced

¿Por qué usar Gear?

Ventajas principales

Escenarios de uso

• ✅ Desarrolladores independientes que usan IA para acelerar el desarrollo

• ✅ Equipos que necesitan que la IA comprenda el estado real del proyecto/tiempo de ejecución

• ✅ Flujos de trabajo de depuración intensivos (puntos de interrupción, seguimiento de pila, inspección en tiempo de ejecución)

Modos de uso de herramientas

Niveles de exposición de herramientas

Gear tiene tres modos de exposición de herramientas:

Grupos de herramientas dinámicos en modo compact

En el modo compact, las 78 herramientas adicionales se organizan en 22 grupos de herramientas dinámicos:

Cómo usar los grupos de herramientas

1. Activación automática (recomendado)

Usa tool.catalog para buscar herramientas relacionadas; los grupos coincidentes se activarán automáticamente

2. Activación manual

Usa tool.groups para activar manualmente grupos específicos "Activa el grupo de herramientas dap para depurar"

3. Desactivación

Usa tool.groups para restablecer los grupos activados

Instalación

Método A: npx (recomendado)

npx -y gear

Método B: Instalación global

npm install -g gear-godot-mcp
gear

Método C: Instalación desde código fuente

git clone https://github.com/HaD0Yun/Gear-godot-mcp.git
cd Gear-godot-mcp
npm install
npm run build
node build/index.js

Resumen de funciones

Edición de escenas

• Crear escenas, añadir/eliminar nodos

• Modificar propiedades de nodos

• Reparentación de nodos

Flujo de trabajo de scripts

• Crear/modificar scripts

• Analizar la estructura de scripts

• Renombrar símbolos

Depuración en tiempo de ejecución

• Inspeccionar el árbol de escenas en tiempo de ejecución

• Establecer puntos de interrupción, ejecución paso a paso

• Ver valores de variables

Entrada y capturas de pantalla

• Inyectar entrada de teclado/ratón

• Capturar la pantalla del juego

• Captura de ventana gráfica

Gestión de activos

• Buscar materiales CC0 (Poly Haven, AmbientCG, Kenney)

• Descargar recursos al proyecto

Variables de entorno

Preguntas frecuentes

Enlaces relacionados

• Documentación de arquitectura

• Hoja de ruta de desarrollo

• Registro de cambios

• Guía de contribución

Licencia

MIT — Ver LICENSE para más detalles.

Agradecimientos

• Servidor MCP original de Coding-Solo

• Mejoras de Gear desarrolladas por HaD0Yun

• Funcionalidad de visualización del proyecto inspirada en tomyud1/godot-mcp