godot-ai
installs/mo · pypistarsforks
How to install godot-ai?
hi-godot/godot-ai
$git clone https://github.com/hi-godot/godot-aiConnect 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, Grok Build, Antigravity, Hermes Ag
README.md
| 1 | <p align="center"> |
| 2 | <img src="docs/hero.png" alt="Godot AI — The wait is over" width="700"> |
| 3 | </p> |
| 4 | |
| 5 | # Godot AI |
| 6 | |
| 7 | [](https://github.com/hi-godot/godot-ai/actions/workflows/ci.yml) |
| 8 | [](https://codecov.io/gh/hi-godot/godot-ai) |
| 9 | [](https://godotengine.org/asset-library/asset/5050) |
| 10 | [](https://discord.gg/FDZ5fr2QkP) |
| 11 | |
| 12 | **Connect MCP clients directly to a live Godot editor** via the [Model Context Protocol](https://modelcontextprotocol.io/introduction). Over **120 ops across ~43 MCP tools** ([full list](docs/TOOLS.md)) let AI assistants (Claude Code, Codex, **Grok Build**, Antigravity, Hermes Agent, etc.) build scenes, edit nodes and scripts, wire signals, and configure UI, materials, animations, particles, cameras, and environments. |
| 13 | |
| 14 | > 🎉 **Now on the [Godot Asset Library](https://godotengine.org/asset-library/asset/5050) and the [new Godot Asset Store](https://store.godotengine.org/asset/dlight/godot-ai/)** — one-click install from Godot's **AssetLib** tab. You'll still need [uv](https://docs.astral.sh/uv/) for the Python server (see [Quick Start](#quick-start)). |
| 15 | |
| 16 | <img src="docs/images/assetlib.png" alt="Godot AI on the Godot Asset Library" width="312"> |
| 17 | |
| 18 | > 💬 **[Join the Discord](https://discord.gg/FDZ5fr2QkP)** — questions, showcases, and contributor chat. |
| 19 | |
| 20 | --- |
| 21 | |
| 22 | <p align="center"> |
| 23 | <img src="docs/images/huddemo.gif" alt="Cyberpunk HUD demo" width="800"><br> |
| 24 | <em>UI demo built in ~2 hours with zero coding, zero image gen, all programmatically drawn by Godot AI — <a href="https://github.com/hi-godot/cyberpunk-hud-demo">source</a></em> |
| 25 | </p> |
| 26 | |
| 27 | --- |
| 28 | |
| 29 | ## Quick Start |
| 30 | |
| 31 | ### Prerequisites |
| 32 | |
| 33 | - Godot `4.5+` (`4.7+` recommended) |
| 34 | - [uv](https://docs.astral.sh/uv/) (for the Python server) |
| 35 | |
| 36 | <details> |
| 37 | <summary>How to install uv (macOS / Linux / Windows / package managers)</summary> |
| 38 | |
| 39 | - **macOS / Linux:** `curl -LsSf https://astral.sh/uv/install.sh | sh` |
| 40 | - **Windows (PowerShell):** `powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"` |
| 41 | - **Prefer your package manager?** `uv` is a popular open-source tool packaged in |
| 42 | most distro repos, so you don't have to pipe a script from the web: |
| 43 | - **Arch:** `sudo pacman -S uv` |
| 44 | - **Debian / Ubuntu:** `sudo apt install uv` (older releases: `pipx install uv` or the script above) |
| 45 | - **Fedora:** `sudo dnf install uv` |
| 46 | - **macOS (Homebrew):** `brew install uv` |
| 47 | - Other options: [uv install docs](https://docs.astral.sh/uv/getting-started/installation/) |
| 48 | |
| 49 | </details> |
| 50 | - An MCP client ([Claude Code](https://docs.anthropic.com/en/docs/claude-code) | [Codex](https://openai.com/index/codex/) | [Antigravity](https://www.antigravity.dev/)) |
| 51 | |
| 52 | ### 1. Install the plugin |
| 53 | |
| 54 | **Recommended — install from source** (always the latest): |
| 55 | |
| 56 | ```bash |
| 57 | git clone https://github.com/hi-godot/godot-ai.git |
| 58 | cp -r godot-ai/plugin/addons/godot_ai your-project/addons/ |
| 59 | ``` |
| 60 | |
| 61 | Or [download the latest release ZIP](https://github.com/hi-godot/godot-ai/releases/latest) and extract `addons/godot_ai` into your project's `addons/` folder. |
| 62 | |
| 63 | <details> |
| 64 | <summary>Or via the Godot Asset Library</summary> |
| 65 | |
| 66 | In Godot, open the **AssetLib** tab, search for **Godot AI**, click **Download**, then **Install**. Note: Asset Library updates lag behind GitHub, so this version may not be the most recent. |
| 67 | |
| 68 | > 🚨 **If installing from the Asset Library**, most issues can be resolved by disabling and re-enabling the plugin in **Project > Project Settings > Plugins**. |
| 69 | |
| 70 | </details> |
| 71 | |
| 72 | ### 2. Enable the plugin |
| 73 | |
| 74 | In Godot: **Project > Project Settings > Plugins** — enable **Godot AI**. |
| 75 | |
| 76 | The plugin will automatically start the MCP server, connect over WebSocket, and show status in the **Godot AI |
People who liked this also viewed
6 picksType
- Figma-Context-MCPMCP server to provide Figma layout information to AI coding agents like CursorMCP ServersJul 2026
- sunnysideFigma-Context-MCPA comprehensive Model Context Protocol (MCP) server that bridges Figma designs with AI development workflows. It provides 30 specialized tools for extracting pixel-perfect code, assets, and component structures directly from Figma designs.MCP ServersApr 2026
- figma-console-mcpYour design system as an API. Connect AI to Figma for extraction, creation, and debugging.MCP ServersJul 2026
- dcc-mcp-coreCore runtime and shared tooling for DCC-MCP: safe, skill-first MCP integration across Maya, Blender, Houdini, Photoshop, and custom DCC hosts.MCP ServersJul 2026
- freecad-mcpFreeCAD MCP(Model Context Protocol) serverMCP ServersJul 2026
- kicad-mcp-proAI-ready MCP server for KiCad: automate schematic, PCB, ERC/DRC, DFM, BOM and manufacturing review from Claude, Cursor, Copilot and other AI agents.MCP ServersJul 2026
