This project provides production-grade MCP server and AI tools for the Godot engine, enabling AI assistants to directly build scenes, edit nodes, scripts, and configure game elements. It targets Godot developers seeking to accelerate game development workflows by leveraging AI for programmatic scene construction and asset manipulation, offering a significant reduction in manual coding effort.

How It Works

The system comprises an MCP client, a Python server (FastMCP), and a Godot Editor Plugin. The AI client communicates with the Python server via HTTP over the MCP protocol. The Python server then establishes a WebSocket connection to the Godot Editor Plugin. The plugin exposes Godot's EditorInterface and SceneTree APIs as MCP tools, allowing AI to interact with and modify the live Godot editor state. This architecture enables AI to perform complex editing tasks programmatically.

Quick Start & Requirements

• Primary install: Install directly from the Godot Asset Library within the Godot editor (search for "Godot AI") or clone the repository and copy the addons/godot_ai folder into your project.
• Prerequisites: Godot 4.3+ (4.4+ recommended), uv (for the Python server), and a compatible MCP client (e.g., Claude Code, Codex, Antigravity).
• Links:
  • Discord: https://discord.gg/hM7k4p4
  • uv install docs: https://astral.sh/uv/install.sh (macOS/Linux), https://astral.sh/uv/install.ps1 (Windows)
  • Full MCP tools list: docs/TOOLS.md

Highlighted Details

• Supports over 120 operations across approximately 39 MCP tools, enabling AI to manage scenes, nodes, scripts, signals, UI, materials, animations, and more.
• Integrates with a wide array of AI clients including Claude Code, Codex, Antigravity, Gemini CLI, Cursor, and others.
• A demo gamelet with a sophisticated save system was reportedly built in approximately 2 hours using only a handful of AI prompts.
• Offers one-click installation via the Godot Asset Library and Asset Store.

Maintenance & Community

• Active community chat available on Discord.
• Development guidelines provided in CONTRIBUTING.md.
• Star History indicates community interest.

Licensing & Compatibility

• License: MIT.
• Compatibility: The MIT license is permissive, generally allowing for commercial use and integration into closed-source projects.

Limitations & Caveats

A specific issue exists on Windows related to uv's hard-linking mechanism and pywin32, which can cause installation failures and lock files. Workarounds involve configuring UV_LINK_MODE=copy for specific clients or manual cache cleanup. The Asset Library version may lag behind the GitHub repository.