io.github.DiegoBr4nd/godot-gut-mcp

Official

by DiegoBr4nd · Python

Servidor MCP que permite ejecutar tests de Godot con GUT desde cualquier IA

Execute Godot tests with GUT framework from AI assistants.

Topics

gamedevgodotgutmcptesting

README.md2 KBView on GitHub

Godot GUT MCP

Servidor MCP que permite a asistentes de IA (Claude, Cursor, etc.) ejecutar las pruebas unitarias de tu juego en Godot usando GUT, y leer los resultados de forma estructurada. Ideal para el ciclo "la IA escribe código → ejecuta los tests → lee los fallos → corrige".

Requisitos

Python 3.10 o superior
Godot 4.x
GUT 9.x instalado en tu proyecto (carpeta res://addons/gut/)

Instalación

bash

pip install godot-gut-mcp

Configuración en Claude Desktop

Añade esto a tu archivo claude_desktop_config.json:

json

{
  "mcpServers": {
    "godot-gut": {
      "command": "uv",
      "args": ["run", "--with", "godot-gut-mcp", "godot-gut-mcp"],
      "env": {
        "GODOT_PATH": "C:/ruta/a/godot.exe",
        "GODOT_PROJECT_PATH": "C:/ruta/a/tu/proyecto"
      }
    }
  }
}

GODOT_PATH: ruta al ejecutable de Godot.
GODOT_PROJECT_PATH: ruta a la carpeta de tu proyecto (la que contiene project.godot).

Herramientas disponibles

Herramienta	Qué hace
`run_all_tests`	Ejecuta toda la suite de pruebas y devuelve un resumen
`run_test_file`	Ejecuta un archivo de pruebas concreto
`get_failures`	Devuelve solo las pruebas que fallaron, con el mensaje y la línea del error

Ejemplo de respuesta

json

{
  "summary": { "passing": 1, "failing": 1, "all_passed": false },
  "tests": [
    {
      "test": "test_suma_basica",
      "status": "failed",
      "message": "expected to equal [2]: Dos más dos debe ser cuatro",
      "line": 4
    }
  ]
}

Licencia

MIT

Install

Configuration

Environment variables

GODOT_PATHrequired

Ruta al ejecutable de Godot (por ejemplo C:/ruta/a/godot.exe)

GODOT_PROJECT_PATHrequired

Ruta a la carpeta del proyecto de Godot (la que contiene project.godot)

claude_desktop_config.json

{
  "mcpServers": {
    "godot-gut-mcp": {
      "command": "uvx",
      "args": [
        "godot-gut-mcp"
      ],
      "env": {
        "GODOT_PATH": "<YOUR_GODOT_PATH>",
        "GODOT_PROJECT_PATH": "<YOUR_GODOT_PROJECT_PATH>"
      }
    }
  }
}