Godot Gut Mcp

io.github.DiegoBr4ndPublished by GitHub account DiegoBr4ndv0.1.2Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyDeveloper Tools AI & ML

Server details

Identifier: io.github.DiegoBr4nd/godot-gut-mcp
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account DiegoBr4nd for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.DiegoBr4nd%2Fgodot-gut-mcp.svg)](https://sourceweft.com/mcp/io.github.DiegoBr4nd%2Fgodot-gut-mcp?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

A local MCP server that lets an AI assistant run Godot unit tests with GUT and read structured pass/fail results.

What you can do: Run the full GUT test suite and get a summary of passing and failing tests with an all-passed flag and per-test details including status, message and error line.
When to use it: Useful when an assistant edits GDScript in a Godot project and should verify changes by running the GUT suite and reading failures to fix them, in a write-code, test, fix loop.
Requirements: Runs as a local process installed from PyPI (godot-gut-mcp) with Python 3.10 or higher. Needs Godot 4.x and GUT 9.x installed in the project under res://addons/gut/. Requires the GODOT_PATH and GODOT_PROJECT_PATH environment variables pointing to the Godot executable and the project folder containing project.godot. Desktop only.

Before you install

The server launches the Godot executable on your machine, so it needs valid local paths and runs your project's tests; test code may execute project logic. No authentication is declared.

Installation

In SourceWeft

Open Godot Gut Mcp in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

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

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

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

Source: README.md at commit 36ed580

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v0.1.2LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts
Declare a license in the repository or the registry entry.