godot-ai

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

What is godot-ai?

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

Overview of godot-ai

What it is

Godot AI is a production-grade MCP (Model Context Protocol) server and set of AI tools for the Godot engine. It connects MCP clients such as Claude Code, Codex, and Cursor to a live Godot editor. The project provides 46 tools and over 120 operations for building scenes, editing nodes and scripts, wiring signals, and configuring UI, materials, animation, particles, cameras, and environments. It is distributed as a Snap and is open source under the MIT license.

Key features

  • 46 tools and 120+ operations for scene building, node and script editing, signal wiring, and configuration of UI, materials, animation, particles, cameras, and environments.
  • Supports GDScript fully (parse-validated, hot-reloaded, attached, outlined) and C# text-only (script_create/script_patch write .cs files, script_manage outlines them, but does not build .NET or report compiler errors).
  • Authenticated local connections: the server and editor accept only connections with rotating credentials; the editor connection is loopback-only.
  • Signed releases with in-editor updater that verifies signatures and files before installation.
  • Project confinement: writes stay inside the project, and project.godot, override.cfg, and .godot/ are off-limits.
  • Anonymous telemetry records installation UUID, event, outcome, duration, platform, and version (never code, scene contents, or project/file names); opt-out available via environment variables or editor settings.

Use cases

  • Rapidly building and iterating on Godot game scenes and UI using natural language prompts from an MCP client.
  • Automating repetitive editor tasks such as creating nodes, attaching scripts, wiring signals, and configuring materials and animations.
  • Running test suites for a game directly from the AI client.
  • Building complete game prototypes (e.g., a voxel block-world game with player, blocks, and save slots) from a handful of prompts.

Getting started

You need Godot 4.7+, uv, and an MCP client.1. Install uv (once):

  • macOS/Linux: sh curl -LsSf https://astral.sh/uv/install.sh | sh
  • Windows (PowerShell): powershell irm https://astral.sh/uv/install.ps1 | iex 2. Install the add-on from the Asset Store (Godot's AssetLib tab), or from a GitHub release into your-project/addons/godot_ai/.3. Enable it: Project → Project Settings → Plugins → Godot AI.4. Connect your client: in the Godot AI dock, press Configure next to your client, or Configure all. Restart the client if it doesn't notice the change.

License and pricing

MIT license. Open source and free.

這是什麼

Godot AI 是一個生產級的 MCP(模型上下文協定)伺服器與 AI 工具組,專為 Godot 引擎設計。它能將 Claude Code、Codex、Cursor 等 MCP 客戶端連接到正在執行的 Godot 編輯器。該專案提供 46 個工具與超過 120 項操作,可用於建立場景、編輯節點與腳本、連接訊號,以及設定 UI、材質、動畫、粒子、攝影機與環境。它以 Snap 形式發行,並採用 MIT 授權的開源軟體。

主要功能

  • 46 個工具與 120+ 項操作,涵蓋場景建立、節點與腳本編輯、訊號連接,以及 UI、材質、動畫、粒子、攝影機與環境的設定。
  • 完整支援 GDScript(語法驗證、熱重載、附加、大綱),C# 僅支援文字模式(script_create/script_patch 寫入 .cs 檔案,script_manage 可產生大綱,但不建置 .NET 或回報編譯錯誤)。
  • 經過驗證的本機連線:伺服器與編輯器僅接受出示輪換憑證的連線,編輯器連線僅限迴路(loopback)。
  • 簽署版本發行,內建編輯器更新器會在安裝前驗證簽章與每個檔案。
  • 專案隔離:寫入操作僅限於專案目錄內,且 project.godot、override.cfg 與 .godot/ 目錄受到保護。
  • 匿名遙測記錄安裝 UUID、事件、結果、持續時間、平台與版本(絕不記錄程式碼、場景內容或專案/檔案名稱);可透過環境變數或編輯器設定選擇退出。

使用情境

  • 使用 MCP 客戶端以自然語言提示快速建立與迭代 Godot 遊戲場景與 UI。
  • 自動化重複的編輯器任務,例如建立節點、附加腳本、連接訊號,以及設定材質與動畫。
  • 直接從 AI 客戶端執行遊戲的測試套件。
  • 從少量提示建立完整的遊戲原型(例如包含玩家、方塊與存檔欄位的體素方塊世界遊戲)。

快速開始

你需要 Godot 4.7+、uv 以及一個 MCP 客戶端。1. 安裝 uv(僅需一次):

  • macOS/Linux: sh curl -LsSf https://astral.sh/uv/install.sh | sh
  • Windows(PowerShell): powershell irm https://astral.sh/uv/install.ps1 | iex 2. 從 Godot 的 AssetLib 分頁或 GitHub 發行版將附加元件安裝到 your-project/addons/godot_ai/。3. 啟用它:專案 → 專案設定 → 外掛程式 → Godot AI。4. 連接你的客戶端:在 Godot AI 面板中,按下客戶端旁的「Configure」或「Configure all」。如果客戶端未注意到變更,請重新啟動它。

授權與價格

MIT 授權。開源且免費。

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/hi-godotgodot-ai.svg)](https://yunodb.com/tools/hi-godotgodot-ai?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/hi-godotgodot-ai?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/hi-godotgodot-ai.svg" alt="Featured on YunoDB" height="20"></a>