mcpField
G
godot-gut-mcp

godot-gut-mcp

Local
github.com/DiegoBr4ndDeveloper Tools0Updated 17w ago
Repository

About godot-gut-mcp

godot-gut-mcp lets AI assistants run GUT unit tests for Godot 4 projects and inspect structured results. It provides separate tools for full suites, individual test files, and failure details.

Key features

  1. 01Run the full test suite
  2. 02Run a specific test file
  3. 03Retrieve failed tests and error lines
  4. 04Return structured test summaries

Use cases

  1. 01Run game tests after code changes
  2. 02Inspect failures during AI-assisted development
  3. 03Focus test runs on one file
  4. 04Review failing test messages and locations

MCP support

It exposes tools to MCP clients for running GUT tests in a Godot project and returning structured results, including failure messages and error lines.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "diegobr4nd-godot-gut": {
      "command": "uvx",
      "args": [
        "godot-gut-mcp"
      ],
      "env": {
        "GODOT_PATH": "<GODOT_PATH>",
        "GODOT_PROJECT_PATH": "<GODOT_PROJECT_PATH>"
      }
    }
  }
}
Run commanduvx godot-gut-mcp
Environment variables to set
GODOT_PATHRuta al ejecutable de Godot (por ejemplo C:/ruta/a/godot.exe)
GODOT_PROJECT_PATHRuta a la carpeta del proyecto de Godot (la que contiene project.godot)

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypigodot-gut-mcp0.1.2

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.