English Français العربية

io.github.DiegoBr4nd/godot-gut-mcp

السجل الرسمي أخرى

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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
إعداد 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>"
            }
        }
    }
}

متغيرات البيئة

  • GODOT_PATH إلزامي Ruta al ejecutable de Godot (por ejemplo C:/ruta/a/godot.exe)
  • GODOT_PROJECT_PATH إلزامي Ruta a la carpeta del proyecto de Godot (la que contiene project.godot)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو io.github.DiegoBr4nd/godot-gut-mcp؟

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

كيف أثبّت io.github.DiegoBr4nd/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 من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.DiegoBr4nd/godot-gut-mcp إلى مفتاح API؟

نعم. يتطلب GODOT_PATH, GODOT_PROJECT_PATH، وتضبطها في إعداداته.

هل io.github.DiegoBr4nd/godot-gut-mcp مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.DiegoBr4nd/godot-gut-mcp؟

ينشره DiegoBr4nd. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.