io.github.DiegoBr4nd/godot-gut-mcp
Servidor MCP que permite ejecutar tests de Godot con GUT desde cualquier IA
Open source Open in the app JSON README (API)
About
Servidor MCP que permite ejecutar tests de Godot con GUT desde cualquier IA
Details
- Kind
- MCP servers
- Topic
- Media, design & games
- Publisher
- diegobr4nd
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.2
- Last push
- 2026-07-01T22:18:12Z
- Repository state
- ativo
- Language
- Python
- Added
- 2026-08-29 03:01:50
- Updated
- 2026-08-29 03:01:50
- Origin id
io.github.DiegoBr4nd/godot-gut-mcp
README
<!-- mcp-name: io.github.DiegoBr4nd/godot-gut-mcp -->
# 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](https://github.com/bitwes/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](https://github.com/bitwes/Gut) instalado en tu proyecto (carpeta `res://addons/gut/`)
## Instalación
```bash
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`:
```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