hi-godot/godot-ai

1천 stars 0 forks 품질 95 트렌드 95

Production-grade MCP server and AI tools for the Godot engine. A Snap to install. Totally free and fun.

개요

via the Model Context Protocol. Over (full list) let AI assistants (Claude Code, Codex, Antigravity, Hermes Agent, etc.) build scenes, edit nodes and scripts, wire signals, and configure UI, materials, animations, particles, cameras, and environments. 🎉 — one-click install from Godot's tab. You'll still need uv for the Python server (see Quick Start). 💬 — questions, showcases, and contributor chat. UI demo built in ~2 hours with zero coding, zero image gen, all programmatically drawn by Godot AI — source - Godot 4.5+ (4.7+ recommended) - uv (for the Python server): - curl -LsSf https://astral.sh/uv/install.sh | sh - powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.

README

Godot AI

Connect MCP clients directly to a live Godot editor via the Model Context Protocol. Over 120 ops across ~43 MCP tools (full list) let AI assistants (Claude Code, Codex, Antigravity, Hermes Agent, etc.) build scenes, edit nodes and scripts, wire signals, and configure UI, materials, animations, particles, cameras, and environments.

🎉 Now on the Godot Asset Library and the new Godot Asset Store — one-click install from Godot’s AssetLib tab. You’ll still need uv for the Python server (see Quick Start).

💬 Join the Discord — questions, showcases, and contributor chat.

UI demo built in ~2 hours with zero coding, zero image gen, all programmatically drawn by Godot AI — source

Quick Start

Prerequisites

Godot 4.5+ (4.7+ recommended)
uv (for the Python server):
- macOS / Linux: curl -LsSf https://astral.sh/uv/install.sh | sh
- Windows (PowerShell): powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
- Prefer your package manager? uv is a popular open-source tool packaged in most distro repos, so you don’t have to pipe a script from the web:
  - Arch: sudo pacman -S uv
  - Debian / Ubuntu: sudo apt install uv (older releases: pipx install uv or the script above)
  - Fedora: sudo dnf install uv
  - macOS (Homebrew): brew install uv
- Other options: uv install docs
An MCP client (Claude Code | Codex | Antigravity)

1. Install the plugin

Recommended — install from source (always the latest):

git clone https://github.com/hi-godot/godot-ai.git
cp -r godot-ai/plugin/addons/godot_ai your-project/addons/

Or download the latest release ZIP and extract addons/godot_ai into your project’s addons/ folder.

2. Enable the plugin

In Godot: Project > Project Settings > Plugins — enable Godot AI.

The plugin will automatically start the MCP server, connect over WebSocket, and show status in the Godot AI dock.

3. Connect your MCP client

The dock lists every supported client with a status dot and per-row Configure / Remove buttons, or press Configure all. Auto-configure covers:

Claude Code, Claude Desktop, Antigravity, Hermes Agent

Server URL is always http://127.0.0.1:8000/mcp. If auto-configure can’t find a CLI, each dock row exposes a Run this manually panel with a copyable snippet.

4. Try it

“Show me the current scene hierarchy.”
“Create a Camera3D named MainCamera under /Main.”
“Search the project for PackedScene files in ui/.”
“Run the scene test suite.”
“Build a voxel block-world game with a player, blocks to place and destroy, and save slots.”

Demo gamelet with sophisticated save system built from a handful of Godot AI MCP prompts. Code and Godot project available free here.

Tools and resources: see docs/TOOLS.md for the full tool, op, and resource list (~43 tools exposing 120+ ops, plus read-only godot:// resources), grouped by domain.

Star History

License: MIT | Issues: GitHub

View this README on GitHub

설치

uvx mcp-proxy==0.11.0 --transport streamablehttp http://127.0.0.1:8000/mcp

설정

{
  "mcpServers": {
    "godot-ai": {
      "serverUrl": "http://127.0.0.1:8000/mcp",
      "disabled": false
    }
  }
}