English Français العربية

io.github.DiegoBr4nd/godot-gut-mcp

Official registry Other

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package godot-gut-mcp
Claude Code 
claude mcp add godot-gut-mcp -e 'GODOT_PATH=<GODOT_PATH>' -e 'GODOT_PROJECT_PATH=<GODOT_PROJECT_PATH>' -- uvx godot-gut-mcp==0.1.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "godot-gut-mcp": {
            "command": "uvx",
            "args": [
                "godot-gut-mcp==0.1.2"
            ],
            "env": {
                "GODOT_PATH": "<GODOT_PATH>",
                "GODOT_PROJECT_PATH": "<GODOT_PROJECT_PATH>"
            }
        }
    }
}

Environment variables

  • GODOT_PATH required Ruta al ejecutable de Godot (por ejemplo C:/ruta/a/godot.exe)
  • GODOT_PROJECT_PATH required Ruta a la carpeta del proyecto de Godot (la que contiene project.godot)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Godot GUT MCP
  2. Requisitos
  3. Instalación
  4. Configuración en Claude Desktop
  5. Configuración en Claude Desktop
  6. Herramientas disponibles
  7. Ejemplo de respuesta
  8. Licencia

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

pip install godot-gut-mcp

Configuración en Claude Desktop

Configuración en Claude Desktop

Añade esto a tu archivo claude_desktop_config.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

HerramientaQué hace
run_all_testsEjecuta toda la suite de pruebas y devuelve un resumen
run_test_fileEjecuta un archivo de pruebas concreto
get_failuresDevuelve solo las pruebas que fallaron, con el mensaje y la línea del error

Ejemplo de respuesta

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

Frequently asked questions

What is io.github.DiegoBr4nd/godot-gut-mcp?

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

How do I install io.github.DiegoBr4nd/godot-gut-mcp?

It runs on your machine. In Claude Code: claude mcp add godot-gut-mcp -e 'GODOT_PATH=<GODOT_PATH>' -e 'GODOT_PROJECT_PATH=<GODOT_PROJECT_PATH>' -- uvx godot-gut-mcp==0.1.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.DiegoBr4nd/godot-gut-mcp need an API key?

Yes. It expects GODOT_PATH, GODOT_PROJECT_PATH, which you set in its configuration.

Is io.github.DiegoBr4nd/godot-gut-mcp open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.DiegoBr4nd/godot-gut-mcp?

It is published by DiegoBr4nd. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.