{
"markdown": "# Godot MCP\n\n**Give your AI assistant full access to the Godot editor.**\n\nBuild games faster with Claude, Cursor, or any MCP-compatible AI — no copy-pasting, no context switching. AI reads, writes, and manipulates your scenes, scripts, nodes, and project settings directly.\n\n> Godot 4.x · 75 tools · Undo/redo · Interactive project visualizer · MIT license\n\n---\n\n## Quick Start\n\n### 0. Install Node.js (one-time setup)\n\nDownload and run the installer from **[nodejs.org](https://nodejs.org/en/download)** (LTS version). It's a standard installer — no terminal needed.\n\n### 1. Install the Godot plugin\n\nInside the Godot editor, click the **AssetLib** tab at the top → search **\"mcp\"** → find **\"Godot AI Assistant tools MCP\"** → Install.\n\nThen go to **Project → Project Settings → Plugins** and enable the **Godot MCP** plugin.\n\n### 2. Add the server config to your AI client\n\n**Claude Desktop** — Settings → Developer → Edit Config → open the config file and paste:\n\nMac / Linux:\n```json\n{\n \"mcpServers\": {\n \"godot\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"godot-mcp-server\"]\n }\n }\n}\n```\n\nWindows:\n```json\n{\n \"mcpServers\": {\n \"godot\": {\n \"command\": \"cmd\",\n \"args\": [\"/c\", \"npx\", \"-y\", \"godot-mcp-server\"]\n }\n }\n}\n```\n\n**Cursor** — Settings → MCP → Add Server:\n\nMac / Linux:\n```json\n{\n \"mcpServers\": {\n \"godot\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"godot-mcp-server\"]\n }\n }\n}\n```\n\nWindows:\n```json\n{\n \"mcpServers\": {\n \"godot\": {\n \"command\": \"cmd\",\n \"args\": [\"/c\", \"npx\", \"-y\", \"godot-mcp-server\"]\n }\n }\n}\n```\n\n**Claude Code** — run in terminal:\n```bash\nclaude mcp add godot -- npx -y godot-mcp-server\n```\n\nWorks with any MCP-compatible client (Cline, Windsurf, etc.)\n\n### 3. Restart your AI client\n\nClose and reopen Claude Desktop / Cursor / your client so it picks up the new config.\n\n### 4. Restart your Godot project\n\nHit **Restart Project** in the Godot editor. Check the **top-right corner** — you should see **MCP Connected** in green. You're ready to go.\n\n---\n\n## What Can It Do?\n\n### 42 Tools Across 6 Categories\n\n| Category | Tools | Examples |\n|----------|-------|---------|\n| **File Operations** | 4 | Browse directories, read files, search project, create scripts |\n| **Scene Operations** | 11 | Create scenes, add/remove/move nodes, set properties, attach scripts, assign collision shapes and textures |\n| **Script Operations** | 6 | Apply code edits, validate syntax, rename/move files with reference updates |\n| **Project Tools** | 14 | Run/stop scenes, query ClassDB, read errors from Output + Debugger, project settings, input map, collision layers, scene tree dumps, rescan filesystem |\n| **Asset Generation** | 1 | Generate 2D sprites from SVG |\n| **Visualization** | 6 | Interactive browser-based project map, scene graph explorer |\n\n### Interactive Visualizer\n\nRun `map_project` and get a browser-based explorer at `localhost:6510`:\n- Force-directed graph of all scripts and their relationships\n- Click any script to see variables, functions, signals, and connections\n- Edit code directly in the visualizer — changes sync to Godot in real time\n- Scene view with node property editing\n- Find usages before refactoring\n\n\n### Limitations\n\nAI cannot create 100% of a game by itself — it struggles with complex UI layouts, compositing scenes, and some node property manipulation. It's still in active development, so feedback is very welcome!\n\n---\n\n## Architecture\n\n```\n┌─────────────┐ MCP (stdio) ┌──────────────┐ WebSocket ┌──────────────┐\n│ AI Client │◄────────────────►│ MCP Server │◄─────────────►│ Godot Editor │\n│ (Claude, │ │ (Node.js) │ port 6505 │ (Plugin) │\n│ Cursor) │ │ │ │ │\n└─────────────┘ │ Visualizer │ │ 42 tool │\n │ HTTP :6510 │ │ handlers │\n └──────┬───────┘ └──────────────┘\n │\n ┌──────▼───────┐\n │ Browser │\n │ Visualizer │\n └──────────────┘\n```\n\n---\n\n## Current Limitations\n\n- **Local only** — runs on localhost, no remote connections\n- **One Godot editor at a time** — multiple AI clients can connect concurrently, but they all share a single Godot instance\n- **Ctrl+Z does not reach AI changes** — the plugin writes to disk rather than the editor's live tree, so Godot's native undo has nothing to revert. Use the `mcp_undo` tool instead (ask the agent to undo).\n- **AI is still limited in Godot knowledge** — it can't create 100% of the game alone, but it can help debug, write scripts, and tag along for the journey\n\n---\n\n## Development\n\nTo build from source instead of using npm:\n\n```bash\ncd mcp-server\nnpm install\nnpm run build\n```\n\nThen point your AI client at `mcp-server/dist/index.js` instead of using `npx`.\n\n---\n\n## Release notes\n\nNarrative write-ups of each release live in [`release-notes/`](./release-notes/) (latest: [v0.6.0](./release-notes/v0.6.0.md)). For the full change history, see [`CHANGELOG.md`](./CHANGELOG.md).\n\n---\n\n## License\n\nMIT\n\n---\n\n## Star History\n\n\n \n \n \n \n \n\n\n---\n\n**[npm package](https://www.npmjs.com/package/godot-mcp-server)** · **[Report Issues](https://github.com/tomyud1/godot-mcp/issues)**\n",
"bytes": 6128,
"sha": "af20a893e738c443ffad5b00e28951e1beedfb697f958829c8392651125a7946",
"repo_slug": "tomyud1/godot-mcp",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/mcp_io_github_tomyud1_godot_mcp_4a704198/readme"
}