hi-godot/godot-ai

What it solves

Godot AI allows AI assistants (like Claude Code or Codex) to interact directly with a live Godot game engine editor. It removes the need for the user to manually copy-paste code or scene configurations between an AI chat and the engine, enabling the AI to programmatically build scenes, edit nodes, and configure game environments in real-time.

How it works

The project uses the Model Context Protocol (MCP) to bridge the gap between AI clients and the Godot editor. A Python server (using FastMCP) acts as a middleman, connecting to the Godot Editor Plugin via WebSockets. AI clients communicate with this server via HTTP or a stdio bridge, allowing the AI to trigger over 120 operations across 43 tools, such as creating nodes, wiring signals, and editing scripts.

Who it’s for

Game developers using the Godot Engine (version 4.5+) who want to use AI agents to automate the tedious parts of game development, such as UI layout, scene assembly, and basic scripting.

Highlights

• Deep Editor Integration: Can build entire scenes, configure materials, animation, particles, and cameras programmatically.
• Broad Client Support: Compatible with a wide range of MCP clients including Claude Code, Claude Desktop, Cursor, and Zed.
• Coded-from-Scratch UI: Capable of programmatically drawing complex UIs without requiring external image generation.
• Integrated Testing: Includes an in-editor GDScript test framework that AI clients can use to write and run test suites for the game.