tekton/addons/godot_ai/README.md

Godot AI

Connect AI assistants to a live Godot editor via the Model Context Protocol (MCP).

Godot AI bridges Claude Code, Codex, Antigravity, and other MCP clients with your editor — inspect scenes, create nodes, modify properties, run tests, search project files, and more, all from a prompt.

Quick Start

1. Copy addons/godot_ai/ into your project's addons/ folder
2. Enable the plugin: Project > Project Settings > Plugins > Godot AI
3. Pick your MCP client in the Godot AI dock and press Configure

The plugin auto-starts the MCP server and connects over WebSocket. No manual configuration required.

Requirements

• Godot 4.3+ (4.4+ recommended)

• uv (used to install the Python server)

  Install uv

  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"
  

  Homebrew (macOS / Linux):

  brew install uv
  

  pipx:

  pipx install uv
  

  See the uv install docs for more options.

• An MCP client (Claude Code | Codex | Antigravity)

Documentation

Full documentation, contributing guide, and source code: github.com/hi-godot/godot-ai

License

MIT