godot-test-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
godot-test-mcp
MCP server for automated Godot 4 game testing. Launch games, capture errors, verify changes — all from Claude Code or any MCP client.
Features (Phase 1)
Launch & Stop: Run Godot projects in headless or windowed mode
Error Capture: Parse and categorize GDScript errors, parse errors, resource failures
One-Shot Verify:
godot_run_and_check— launch, run N seconds, report PASS/FAILHeadless Import: Quick parse-check without running the game
Related MCP server: godot-devtool
Quick Start
Clone:
git clone https://github.com/hyunlord/godot-test-mcp.gitInstall:
cd godot-test-mcp pip install -e .Add to your Godot project's
.mcp.json:{ "mcpServers": { "godot-test": { "command": "python3", "args": ["/path/to/godot-test-mcp/src/server.py"], "env": { "GODOT_PROJECT_PATH": ".", "GODOT_PATH": "" } } } }In Claude Code:
godot_run_and_check(seconds=15)
Tools
Tool | Description |
| Start Godot (headless/windowed/editor) |
| Stop running Godot process |
| Get parsed errors/warnings |
| Get raw stdout/stderr |
| Launch → run N sec → collect errors → PASS/FAIL |
| Quick --headless --quit parse check |
| Check if Godot is running/stopped/crashed |
Environment Variables
Variable | Description |
| Path to Godot executable (auto-detected if empty) |
| Path to Godot project root (auto-detected if empty) |
Godot Auto-Detection
If GODOT_PATH is not set, the server searches in order:
macOS:
/Applications/Godot.app/Contents/MacOS/Godot,~/Applications/...Linux:
/usr/bin/godot, snap/flatpak pathsWindows:
C:\Godot\Godot.exe,%LOCALAPPDATA%\Godot\...PATHlookup viawhich godot
Project Auto-Detection
If GODOT_PROJECT_PATH is not set, the server searches for project.godot starting from the current directory and walking up to 5 parent directories.
Roadmap
Phase 1: Launch + error capture (current)
Phase 2: Tick control + entity state query (WebSocket)
Phase 3: Cheat commands + assertions
Phase 4: Rust/GPU profiling
Phase 5: CI/CD integration
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Make games with AI: one MCP server that connects your agent to Unity, Unreal and Godot editors.
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
MCP server for Grok Imagine AI video generation
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that gives AI assistants direct control over Godot 4 game development projects. It enables launching the editor, running projects, creating and editing scenes, writing GDScript, and inspecting assets through natural language commands.444MIT
- AlicenseAqualityFmaintenanceA Godot 4 MCP server for AI-assisted project inspection, editing, validation, and runtime automation via stdio and optional WebSocket bridge.389MIT
- AlicenseBqualityCmaintenanceMCP server for Godot Engine enabling AI to autonomously develop, test, and debug games with deterministic playtesting, multiplayer testing, DAP debugging, LSP integration, and token efficiency.3115MIT
- AlicenseAqualityCmaintenanceAn MCP server that lets AI coding agents work on Godot 4 projects, including reading and editing scenes, writing and validating GDScript, running the game, and capturing screenshots.2518 npmMIT