[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-1594":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":32,"readmeContent":33,"aiSummary":34,"trendingCount":16,"starSnapshotCount":16,"syncStatus":35,"lastSyncTime":36,"discoverSource":37},1594,"godot-ai","hi-godot\u002Fgodot-ai","hi-godot","Production-grade MCP server and AI tools for the Godot engine. A Snap to install. Totally free and fun.","",null,"GDScript",521,32,5,28,0,40,90,289,120,98.56,"MIT License",false,"main",true,[27,28,29,30,31],"ai","game-development","godot","godot-plugin","mcp","2026-06-12 04:00:10","\u003Cp align=\"center\">\n  \u003Cimg src=\"docs\u002Fhero.png\" alt=\"Godot AI — The wait is over\" width=\"700\">\n\u003C\u002Fp>\n\n# Godot AI\n\n[![CI](https:\u002F\u002Fgithub.com\u002Fhi-godot\u002Fgodot-ai\u002Factions\u002Fworkflows\u002Fci.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Fhi-godot\u002Fgodot-ai\u002Factions\u002Fworkflows\u002Fci.yml)\n[![codecov](https:\u002F\u002Fcodecov.io\u002Fgh\u002Fhi-godot\u002Fgodot-ai\u002Fgraph\u002Fbadge.svg)](https:\u002F\u002Fcodecov.io\u002Fgh\u002Fhi-godot\u002Fgodot-ai)\n[![Godot Asset Library](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FGodot-Asset%20Library-478cbf?logo=godotengine&logoColor=white)](https:\u002F\u002Fgodotengine.org\u002Fasset-library\u002Fasset\u002F5050)\n[![Discord](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-Join%20chat-5865F2?logo=discord&logoColor=white)](https:\u002F\u002Fdiscord.gg\u002FFDZ5fr2QkP)\n\n**Connect MCP clients directly to a live Godot editor** via the [Model Context Protocol](https:\u002F\u002Fmodelcontextprotocol.io\u002Fintroduction). Over **120 ops across ~39 MCP tools** ([full list](docs\u002FTOOLS.md)) let AI assistants (Claude Code, Codex, Antigravity, etc.) build scenes, edit nodes and scripts, wire signals, and configure UI, materials, animations, particles, cameras, and environments.\n\n> 🎉 **Now on the [Godot Asset Library](https:\u002F\u002Fgodotengine.org\u002Fasset-library\u002Fasset\u002F5050) and the [new Godot Asset Store](https:\u002F\u002Fstore.godotengine.org\u002Fasset\u002Fdlight\u002Fgodot-ai\u002F)** — one-click install from Godot's **AssetLib** tab. You'll still need [uv](https:\u002F\u002Fdocs.astral.sh\u002Fuv\u002F) for the Python server (see [Quick Start](#quick-start)).\n\n\u003Cimg src=\"docs\u002Fimages\u002Fassetlib.png\" alt=\"Godot AI on the Godot Asset Library\" width=\"312\">\n\n> 💬 **[Join the Discord](https:\u002F\u002Fdiscord.gg\u002FFDZ5fr2QkP)** — questions, showcases, and contributor chat.\n\n---\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"docs\u002Fimages\u002Fhuddemo.gif\" alt=\"Cyberpunk HUD demo\" width=\"800\">\u003Cbr>\n  \u003Cem>UI demo built in ~2 hours with zero coding, zero image gen, all programmatically drawn by Godot AI — \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fhi-godot\u002Fcyberpunk-hud-demo\">source\u003C\u002Fa>\u003C\u002Fem>\n\u003C\u002Fp>\n\n---\n\n## Quick Start\n\n### Prerequisites\n\n- Godot `4.3+` (`4.4+` recommended)\n- [uv](https:\u002F\u002Fdocs.astral.sh\u002Fuv\u002F) (for the Python server):\n  - **macOS \u002F Linux:** `curl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh`\n  - **Windows (PowerShell):** `powershell -ExecutionPolicy ByPass -c \"irm https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.ps1 | iex\"`\n  - Other options: [uv install docs](https:\u002F\u002Fdocs.astral.sh\u002Fuv\u002Fgetting-started\u002Finstallation\u002F)\n- An MCP client ([Claude Code](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code) | [Codex](https:\u002F\u002Fopenai.com\u002Findex\u002Fcodex\u002F) | [Antigravity](https:\u002F\u002Fwww.antigravity.dev\u002F))\n\n### 1. Install the plugin\n\n**Recommended — install from source** (always the latest):\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fhi-godot\u002Fgodot-ai.git\ncp -r godot-ai\u002Fplugin\u002Faddons\u002Fgodot_ai your-project\u002Faddons\u002F\n```\n\nOr [download the latest release ZIP](https:\u002F\u002Fgithub.com\u002Fhi-godot\u002Fgodot-ai\u002Freleases\u002Flatest) and extract `addons\u002Fgodot_ai` into your project's `addons\u002F` folder.\n\n\u003Cdetails>\n\u003Csummary>Or via the Godot Asset Library\u003C\u002Fsummary>\n\nIn 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.\n\n> 🚨 **If installing from the Asset Library**, most issues can be resolved by disabling and re-enabling the plugin in **Project > Project Settings > Plugins**.\n\n\u003C\u002Fdetails>\n\n### 2. Enable the plugin\n\nIn Godot: **Project > Project Settings > Plugins** — enable **Godot AI**.\n\nThe plugin will automatically start the MCP server, connect over WebSocket, and show status in the **Godot AI** dock.\n\n\u003Cp align=\"center\">\u003Cimg src=\"docs\u002Fimages\u002Fdock.png\" alt=\"Godot AI dock — Clients & Tools button highlighted\" width=\"350\">\u003C\u002Fp>\n\n### 3. Connect your MCP client\n\nThe dock lists every supported client with a status dot and per-row\n**Configure** \u002F **Remove** buttons, or press **Configure all**. Auto-configure\ncovers:\n\n- **Claude Code**, **Claude Desktop**, **Antigravity**\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>…and 15+ more clients\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nCodex, Cursor, Windsurf, VS Code, VS Code Insiders, Zed, Gemini CLI, Cline,\nKilo Code, Roo Code, Kiro, Trae, Cherry Studio, OpenCode, Qwen Code.\n\n\u003C\u002Fdetails>\n\nServer URL is always `http:\u002F\u002F127.0.0.1:8000\u002Fmcp`. If auto-configure can't find\na CLI, each dock row exposes a **Run this manually** panel with a copyable\nsnippet.\n\n### 4. Try it\n\n- *\"Show me the current scene hierarchy.\"*\n- *\"Create a Camera3D named MainCamera under \u002FMain.\"*\n- *\"Search the project for PackedScene files in ui\u002F.\"*\n- *\"Run the scene test suite.\"*\n- *\"Build a voxel block-world game with a player, blocks to place and destroy, and save slots.\"*\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"docs\u002Fimages\u002Fblockarena.gif\" alt=\"Block-world game scene built from MCP tool calls — voxel terrain, player, and UI\" width=\"640\">\n\u003C\u002Fp>\n\u003Cp align=\"center\">\u003Cem>Demo gamelet with sophisticated save system built from a handful of Godot AI MCP prompts. Code and Godot project  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fdsarno\u002Fsave-system-godot-claude\">available free here\u003C\u002Fa>.\u003C\u002Fem>\u003C\u002Fp>\n\n---\n\n**Tools and resources:** see [docs\u002FTOOLS.md](docs\u002FTOOLS.md) for the full list of 120+ MCP tools and resources, grouped by domain.\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Manual Client Configuration\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n**Claude Code**\n\n```bash\nclaude mcp add --scope user --transport http godot-ai http:\u002F\u002F127.0.0.1:8000\u002Fmcp\n```\n\n**Codex** (`~\u002F.codex\u002Fconfig.toml`)\n\n```toml\n[mcp_servers.\"godot-ai\"]\nurl = \"http:\u002F\u002F127.0.0.1:8000\u002Fmcp\"\nenabled = true\n```\n\n**Antigravity** (`~\u002F.gemini\u002Fantigravity\u002Fmcp_config.json`)\n\n```json\n{\n  \"mcpServers\": {\n    \"godot-ai\": {\n      \"serverUrl\": \"http:\u002F\u002F127.0.0.1:8000\u002Fmcp\",\n      \"disabled\": false\n    }\n  }\n}\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>How It Works\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n```text\nMCP Client\n   | HTTP (\u002Fmcp)\n   v\nPython Server (FastMCP)      port 8000\n   | WebSocket               port 9500\n   v\nGodot Editor Plugin\n   | EditorInterface + SceneTree APIs\n   v\nGodot Editor\n```\n\nThe plugin starts or reuses the Python server, connects over WebSocket, and exposes editor capabilities as MCP tools and resources over HTTP.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Windows: \u003Ccode>uvx mcp-proxy\u003C\u002Fcode> won't start (\u003Ccode>pywin32\u003C\u002Fcode> install fails)\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nSymptom (in your MCP client's server log):\n\n```text\nerror: Failed to install: pywin32-311-cp313-cp313-win_amd64.whl (pywin32==311)\n  Caused by: failed to remove directory `C:\\Users\\\u003Cyou>\\AppData\\Local\\uv\\cache\\builds-v0\\.tmpXXXXXX\\Lib\\site-packages\\pywin32-311.data`: ... os error 32\n```\n\nCause: uv hard-links shared `.pyd` files (notably\n`pydantic_core\u002F_pydantic_core.cp313-win_amd64.pyd`) from `archive-v0\\` into\neach new `builds-v0\\.tmpXXXXXX\\` build venv. The running `godot-ai` Python\nprocess has the same `.pyd` mapped via `LoadLibrary` — and because hard\nlinks share the inode, Windows refuses to delete it under any path until\nevery process unmaps it. uv's post-install cleanup of the build venv then\ndies on a stale lock; the misleading `pywin32` mention is just the last\npackage in the resolution order, not the actual lock holder.\n\n**Mitigation in this plugin:**\n\n1. `_stop_server` and `force_restart_server` both call\n   `McpUvCacheCleanup.purge_stale_builds()` immediately after killing the\n   server children, while the `.pyd` is briefly unmapped. See\n   [`plugin\u002Faddons\u002Fgodot_ai\u002Futils\u002Fuv_cache_cleanup.gd`](plugin\u002Faddons\u002Fgodot_ai\u002Futils\u002Fuv_cache_cleanup.gd).\n2. **Auto-configure now writes `UV_LINK_MODE=copy` into the bridged\n   entry's `env` block** for every uvx-bridge client (Claude Desktop, Zed),\n   telling uv to copy shared C extensions instead of hard-linking them.\n   That removes the reverse race where an MCP client spawns `uvx mcp-proxy`\n   *while* a server child still holds the `.pyd`. Existing entries written\n   by older plugin versions surface in the dock as **drift (amber banner)**\n   so a single Configure click rewrites them with the env pin.\n\nThe shape `client_configure` writes for Claude Desktop is now:\n\n```json\n{\n  \"mcpServers\": {\n    \"godot-ai\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-proxy==0.11.0\", \"--transport\", \"streamablehttp\", \"http:\u002F\u002F127.0.0.1:8000\u002Fmcp\"],\n      \"env\": { \"UV_LINK_MODE\": \"copy\" }\n    }\n  }\n}\n```\n\nIf you've already hit the lock on an older config, click **Configure**\non the affected uvx-bridge client (Claude Desktop *or* Zed) in the\ngodot-ai dock to rewrite the entry with the env pin, then quit and\nreopen that client. If the lock persists (rare — pre-existing orphans\nthe cache sweeper couldn't reach), kill stray `python.exe` children\nwhose command line contains `spawn_main(parent_pid=...)` and delete\n`%LOCALAPPDATA%\\uv\\cache\\builds-v0\\.tmp*` manually before retrying.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Contributing\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nSee [CONTRIBUTING.md](docs\u002FCONTRIBUTING.md) for development setup, testing, and PR guidelines.\n\n**Windows contributors:** run `.\\script\\setup-dev.ps1` in PowerShell. It builds `test_project\\addons\\godot_ai` as a directory junction — no admin rights and no Windows Developer Mode required.\n\n\u003C\u002Fdetails>\n\n---\n\n## Star History\n\n\u003Ca href=\"https:\u002F\u002Fstar-history.com\u002F#hi-godot\u002Fgodot-ai&Date\">\n  \u003Cimg src=\"https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=hi-godot\u002Fgodot-ai&type=Date\" alt=\"Star History Chart\" width=\"700\">\n\u003C\u002Fa>\n\n---\n\n**License:** [MIT](LICENSE) | **Issues:** [GitHub](https:\u002F\u002Fgithub.com\u002Fhi-godot\u002Fgodot-ai\u002Fissues)\n","Godot AI 是一个为 Godot 引擎设计的生产级 MCP 服务器和 AI 工具集。它通过 Model Context Protocol（MCP）使 AI 助手能够直接连接到实时的 Godot 编辑器，支持超过 120 种操作和约 39 个工具，涵盖场景构建、节点编辑、脚本编写、信号连接及 UI、材质、动画等多方面功能。该项目使用 GDScript 开发，提供了一键安装的便捷性，并且完全免费。适合游戏开发者利用 AI 技术加速开发流程，提高效率，特别是在需要快速原型制作或复杂场景搭建时尤为有用。",2,"2026-06-11 02:44:55","CREATED_QUERY"]