Godot AI

Godot AI

Godot AI connects Claude Code, Claude Desktop, Codex, Hermes Agent, and other
MCP clients to a live Godot
editor. Its 46 tools and 120+ operations let AI assistants
build scenes, edit nodes and scripts, wire signals, and configure UI, materials,
animation, particles, cameras, and environments.

  Built in ~2 hours with Godot AI, without hand-written code or image generation — source

Quick Start

Requirements

- Godot 4.7+ within the 4.x line for Godot AI v4
- uv, which provides
  uvx for the Python server
- An MCP client

Script languages. GDScript is fully supported: scripts written through
the tools are parse-validated, hot-reloaded, attached, and outlined. C# is
text-only: script_create / script_patch write .cs files and
script_manage(op="find_symbols") outlines them, but Godot AI does not build
.NET or report C# compiler errors. Build in the editor and inspect its Build
panel, or run dotnet build and inspect the terminal output.
Attaching a .cs needs a .NET-enabled editor build.
Details: C# support.

1. Install or update

New project: choose a published version from
GitHub Releases and follow its
verification and installation instructions. The add-on belongs at
your-project/addons/godot_ai/, with plugin.cfg inside that directory.
Use the release's requirements and package—not a source snapshot copied over
an existing installation.

Existing installation: click Update in the Godot AI dock when an update
is offered. The final signed v3 release supports a one-click migration to v4;
Godot restarts once and owned, supported client entries are migrated
automatically. Do not extract a new add-on over the old tree. See the
v3 → v4 migration guide for compatibility and recovery.

For development from source, use the contributor setup.

2. Enable the plugin

In Godot: Project → Project Settings → Plugins → Godot AI.

The plugin starts the MCP server and shows connection status in the Godot AI
dock. If it is missing from the plugin list, check that the file is at
addons/godot_ai/plugin.cfg, not addons/plugin.cfg.

3. Connect your MCP client

In the dock, press Configure next to your client, or Configure all for
every detected client. If the client does not notice the new configuration,
restart that client.

Supported clients include Claude Code, Claude Desktop, Codex,
Antigravity, Hermes Agent, DeepSeek Harness, Cursor,
VS Code, and Oh My Pi (manual configuration).
The dock lists all supported clients and provides a Run this manually
fallback where needed.

Use the dock-generated command: it includes the matching version, ports,
resolver options, and excluded tool domains. V4 uses godot-ai attach over
stdio; a bare http://127.0.0.1:8000/mcp entry cannot authenticate or follow
capability rotation. Updates repin owned client entries automatically;
reconfigure after changing ports, telemetry preferences, or tool domains.

Client exceptions: Pi Coding Agent needs an MCP extension that reads
~/.pi/agent/mcp.json. Cherry Studio is not supported in v4; remove stale v3
entries in Cherry Studio itself.

Per-project configuration

CLI-configured clients default to global user scope. Set Editor Settings →
Plugins → godot_ai/mcp_client_scope to proje

……（后略，见原文）