satelliteoflove/godot-mcp

View on GitHub ↗

Give your AI assistant eyes and hands in the Godot editor: scene editing, input injection, deterministic playtesting, and live game state for agents

144 ★20 forksGDScriptUpdated 21d ago

What you need to know

MCP server giving AI assistants eyes and hands in the Godot editor plus a running game they can deterministically playtest and verify.

Install

npx @satelliteoflove/godot-mcp, then install the Godot addon in the project.

Usage

  • •Configure the MCP client, enable the plugin, and restart the assistant.

Key features

  • ✓deterministic frozen-time stepping
  • ✓structured live game state as JSON
  • ✓real input injection (actions, joypad, keys, mouse, text)
  • ✓GDScript scenario setup
  • ✓21 tools / 86 actions
  • ✓read/write split for permission gating
Platforms: Windows · macOS · Linux (WSL2 supported)Clients: Claude Desktop · Claude Code · VS Code/Copilot

Reviewed 2026-08-11

Topics

ai-agentsclaudegame-developmentgdscriptgodotgodot-addongodot-enginemcpmcp-servermodel-context-protocol
Stars
144★
Forks
20
Language
GDScript
License
MIT
Created
2025-12-21
Last push
2026-08-14