godot-gut-mcp について
godot-gut-mcpは、AIアシスタントからGodot 4プロジェクトのGUT単体テストを実行し、構造化された結果を確認できるサーバーです。全テスト、個別ファイル、失敗の詳細を扱うツールを備えています。
主な機能
- 01テストスイート全体の実行
- 02指定したテストファイルの実行
- 03失敗したテストとエラー行の取得
- 04構造化されたテスト概要の返却
活用シーン
- 01コード変更後のゲームテスト
- 02AI支援開発中の失敗確認
- 03特定ファイルに絞ったテスト実行
- 04失敗メッセージと発生箇所の確認
MCP 対応
GodotプロジェクトでGUTテストを実行し、失敗メッセージやエラー行を含む構造化結果を返すツールをMCPクライアントに提供します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
mcp.json · 共通設定
起動コマンド
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 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
ツール一覧はまだ取得されていません
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
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 の設定
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
}
]
}
ライセンス
MIT
コメント
Markdown 対応
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。