English Français العربية

io.github.DiegoBr4nd/godot-gut-mcp

Registre officiel Autres

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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
Configuration JSON (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>"
            }
        }
    }
}

Variables d'environnement

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

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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

Questions fréquentes

Qu'est-ce que io.github.DiegoBr4nd/godot-gut-mcp ?

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

Comment installer io.github.DiegoBr4nd/godot-gut-mcp ?

Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.DiegoBr4nd/godot-gut-mcp ?

Oui. Il attend GODOT_PATH, GODOT_PROJECT_PATH, à renseigner dans sa configuration.

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

Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.

Qui maintient io.github.DiegoBr4nd/godot-gut-mcp ?

Il est publié par DiegoBr4nd. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.