godot-gut-mcp

Name: godot-gut-mcp
Author: DiegoBr4nd

本地服务

github.com/DiegoBr4nd开发工具017 周前更新

代码仓库

关于 godot-gut-mcp

godot-gut-mcp 可让 AI 助手为 Godot 4 项目运行 GUT 单元测试，并查看结构化结果。它提供运行全套测试、指定测试文件及获取失败详情的工具。

主要功能

01运行完整测试套件
02运行指定测试文件
03获取失败测试及错误行
04返回结构化测试摘要

适用场景

01代码更改后运行游戏测试
02在 AI 辅助开发中检查失败
03仅运行某个测试文件
04查看失败信息及其位置

MCP 相关

它向 MCP 客户端提供工具，用于运行 Godot 项目中的 GUT 测试并返回结构化结果，包括失败信息和错误行。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "diegobr4nd-godot-gut": {
      "command": "uvx",
      "args": [
        "godot-gut-mcp"
      ],
      "env": {
        "GODOT_PATH": "<GODOT_PATH>",
        "GODOT_PROJECT_PATH": "<GODOT_PROJECT_PATH>"
      }
    }
  }
}

启动命令uvx godot-gut-mcp

需要配置的环境变量

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)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypigodot-gut-mcp0.1.2stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Godot GUT MCP

MCP 服务，允许 AI 助手（Claude、Cursor 等）使用 GUT 执行 Godot 游戏的单元测试，并以结构化形式读取结果。适合用于 “AI 编写代码 → 运行测试 → 读取失败项 → 修复”的循环。

要求

Python 3.10 或更高版本
Godot 4.x
项目中已安装 GUT 9.x（目录 res://addons/gut/）

安装

pip install godot-gut-mcp

在 Claude Desktop 中配置

将以下内容添加到 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：Godot 可执行文件的路径。
GODOT_PROJECT_PATH：项目文件夹的路径（其中包含 project.godot）。

可用工具

工具	功能
`run_all_tests`	运行整个测试套件并返回摘要
`run_test_file`	运行指定的测试文件
`get_failures`	仅返回失败的测试，并附上错误消息和错误行号

响应示例

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