regiellis/godot-mcp-go
View on GitHub ↗Give AI agents the complete Godot development loop: discover, build, play, observe, debug, fix, and verify from a CLI or MCP client.
40 ★3 forksGDScriptUpdated 22d ago
What you need to know
Go CLI plus GDScript editor addon that drives a running Godot 4.7+ editor over WebSocket - 329 commands across 50 groups. Also serves as an MCP server (stdio or the addon's own streamable HTTP endpoint); typed tool schemas are built live from the addon's parameter docs.
Install
go build -o bin/godot-mcp ./cmd/godot-mcp godot-mcp install --project /path/to/project --enable
Usage
- •Drive the editor from a shell (godot-mcp scene tree, node add, etc.) or via an MCP client with godot-mcp serve.
Key features
- ✓329 commands across 50 groups
- ✓CLI-first, shell-drivable
- ✓Control of the running game (runtime/input groups)
- ✓Debug breakpoints and hot reload
- ✓C# project scaffolding and build
- ✓Live engine introspection (ClassDB)
Best for
Building and playtesting Godot games from a terminal or AI agent
Caveats
- ⚠Requires Godot 4.7+
- ⚠Default typed MCP surface is ~50k tokens; use serve --typed=false for context-constrained models
Platforms: Windows · Linux · macOSClients: Claude Desktop · Claude Code
Reviewed 2026-08-11
Topics
- Stars
- 40★
- Forks
- 3
- Language
- GDScript
- License
- MIT
- Created
- 2026-07-23
- Last push
- 2026-08-14