@satelliteoflove/godot-mcp

What it does

This MCP server integrates Claude with Godot Engine 4.5+, letting it inspect and modify both the editor and the running game. The server provides 15 tools covering scene editing, node manipulation, animation, input injection, game-time stepping, profiling, and live state inspection. The design emphasizes verification: agents can run the game, observe entity state as structured JSON (positions, velocities, animations, custom data), deterministically step the game clock, inject precise input sequences, and run GDScript to set up test scenarios—all without relying on pixel-based screenshot analysis.

Who it's for

Game developers using Godot 4.5+ who want Claude to collaborate on level design, game mechanics, and testing. Useful for teams automating scenario setup (spawning enemies, granting weapons, skipping to specific waves) and QA-like playtest verification without manual intervention.

Common use cases

• Observe live game state (enemy positions, velocities, animation frames) by stepping the game clock deterministically.
• Set up test scenarios by running GDScript commands inside the running game (grant weapons, spawn NPCs, jump to wave N).
• Inject realistic input sequences (action buttons, stick angles, key combinations) and verify the game state changed as claimed.
• Profile frame-time spikes during gameplay and pinpoint performance bottlenecks.
• Iterate on level layout, collision shapes, and animations with Claude feedback based on structured state, not screenshots.

Setup pitfalls

• Requires Godot 4.5+ and Node 20+; older versions will not work. Check your engine version before installing.
• The addon must be installed via npx @satelliteoflove/godot-mcp --install-addon /path/to/project and explicitly enabled in Project > Project Settings > Plugins > Godot MCP.
• Reads and writes files in your project directory; ensure the service has filesystem permissions to install the addon and edit scenes.
• Runtime state inspection and input injection require the game to be actively running; the server cannot observe or test a stopped game.