{
"markdown": "# Better Godot MCP\n\nmcp-name: io.github.n24q02m/better-godot-mcp\n\n**Composite MCP server for Godot Engine -- 17 composite tools for AI-assisted game development.**\n\n\n[](https://github.com/n24q02m/better-godot-mcp/actions/workflows/ci.yml)\n[](https://codecov.io/gh/n24q02m/better-godot-mcp)\n[](https://www.npmjs.com/package/@n24q02m/better-godot-mcp)\n[](https://hub.docker.com/r/n24q02m/better-godot-mcp)\n[](LICENSE)\n\n\n[](#)\n[](#)\n[](#)\n[](https://github.com/python-semantic-release/python-semantic-release)\n[](https://developer.mend.io/)\n\n\n\n Sister projects from n24q02m (click to expand)
\n\n| Project | Tagline | Tag |\n|---|---|---|\n| [agent-chat-plugin](https://github.com/n24q02m/agent-chat-plugin) | Peer AI agents chat in a shared folder — no human relay, no orchestrator, wor... | Tooling |\n| [better-code-review-graph](https://github.com/n24q02m/better-code-review-graph) | Knowledge graph for token-efficient code reviews -- semantic search and call-... | MCP |\n| [better-drive](https://github.com/n24q02m/better-drive) | 2-way Google Drive sync with .driveignore filter — rclone engine, Windows tray | Tooling |\n| [better-email-mcp](https://github.com/n24q02m/better-email-mcp) | IMAP/SMTP email for AI agents -- read, send, organize folders, and manage att... | MCP |\n| [better-godot-mcp](https://github.com/n24q02m/better-godot-mcp) | Composite MCP server for Godot Engine -- 17 composite tools for AI-assisted g... | MCP |\n| [better-notion-mcp](https://github.com/n24q02m/better-notion-mcp) | Markdown-first Notion for AI agents -- pages, databases, blocks, and comments... | MCP |\n| [better-semantic-release](https://github.com/n24q02m/better-semantic-release) | Drop-in python-semantic-release fork with built-in release-safety guards (orp... | Tooling |\n| [better-telegram-mcp](https://github.com/n24q02m/better-telegram-mcp) | Telegram for AI agents -- messages, chats, media, and contacts across both bo... | MCP |\n| [better-workspace-mcp](https://github.com/n24q02m/better-workspace-mcp) | Google Workspace MCP server (Docs/Drive/Calendar/Gmail/Sheets/Slides/Tasks/Ch... | MCP |\n| [claude-plugins](https://github.com/n24q02m/claude-plugins) | Claude Code plugin marketplace for the n24q02m MCP servers -- install web sea... | Marketplace |\n| [imagine-mcp](https://github.com/n24q02m/imagine-mcp) | Image and video understanding + generation for AI agents -- across Gemini, Op... | MCP |\n| [jules-task-archiver](https://github.com/n24q02m/jules-task-archiver) | Chrome Extension for bulk operations on Jules tasks via batchexecute API -- a... | Tooling |\n| [mcp-core](https://github.com/n24q02m/mcp-core) | Shared foundation for building MCP servers -- Streamable HTTP transport, OAut... | MCP |\n| [mnemo-mcp](https://github.com/n24q02m/mnemo-mcp) | Persistent AI memory with hybrid search and embedded sync. Open, free, unlimi... | MCP |\n| [qwen3-embed](https://github.com/n24q02m/qwen3-embed) | Lightweight Qwen3 text embedding and reranking via ONNX Runtime and GGUF | Library |\n| [skret](https://github.com/n24q02m/skret) | Secrets without the server. | CLI |\n| [tacet](https://github.com/n24q02m/tacet) | A self-distilling neuro-symbolic cascade that amortises LLM cost across knowl... | Tooling |\n| [web-core](https://github.com/n24q02m/web-core) | Shared web infrastructure package for search, scraping, HTTP security, and st... | Library |\n| [wet-mcp](https://github.com/n24q02m/wet-mcp) | Open-source MCP server for AI agents: web search, content extraction, and lib... | MCP |\n\n \n\n\n## Table of contents\n\n- [Features](#features)\n- [Install](#install)\n- [Smithery](#smithery)\n- [Documentation](#documentation)\n- [Tools](#tools)\n- [Comparison](#comparison)\n- [Configuration](#configuration)\n- [CLI](#cli)\n- [Security](#security)\n- [Build from source](#build-from-source)\n- [Trust model](#trust-model)\n- [License](#license)\n\n\n\n\n ![\"Better](\"https://glama.ai/mcp/servers/n24q02m/better-godot-mcp/badge\")
\n\n\n## Features\n\n- **17 composite mega-tools** -- scene, node, script, shader, animation, tilemap, physics, audio, navigation, UI, and more\n- **Full scene control** -- create, parse, and modify `.tscn` files directly without Godot running\n- **GDScript CRUD** -- create, read, write, and attach scripts in a single call\n- **Tiered token optimization** -- compressed descriptions + on-demand `help` tool\n\n## Install\n\nRuns over **stdio** by default. No credentials, no account, no relay -- the server reads and writes your local Godot project files directly. Godot 4.x is optional for file operations; only `run`/`stop`/`export` and `editor` actions need a Godot binary. The detector accepts Godot >=4.1. Live engine compatibility is currently verified with Godot 4.7.1 stable; this does not claim that every future minor release has been verified.\n\n### Via npx (recommended)\n\n```bash\nnpx -y @n24q02m/better-godot-mcp@latest\n```\n\n### MCP client config\n\nAdd to your client's MCP config (Claude Code, Cursor, Windsurf, Codex, `mcp.json`):\n\n```json\n{\n \"mcpServers\": {\n \"better-godot-mcp\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@n24q02m/better-godot-mcp\"],\n \"env\": {\n \"GODOT_PROJECT_PATH\": \"/path/to/your/godot/project\"\n }\n }\n }\n}\n```\n\n`GODOT_PROJECT_PATH` is optional -- every tool also accepts a `project_path` argument per call.\n\n### Via Docker\n\n```bash\ndocker run -i --rm -v /path/to/your/godot/project:/project n24q02m/better-godot-mcp\n```\n\nThe image is published for `amd64` and `arm64`. Mount your project directory so the server can read and write scene, script, and resource files.\n\n## Smithery\n\nbetter-godot-mcp ships a [`smithery.yaml`](smithery.yaml) so it can be discovered and deployed through [Smithery](https://smithery.ai/). Smithery launches the server over **stdio** via `npx -y @n24q02m/better-godot-mcp`, and no configuration is required to start -- the server has no credentials and reads your local Godot project files directly.\n\n## Documentation\n\nFull setup guide at **[mcp.n24q02m.com/servers/better-godot-mcp/setup/](https://mcp.n24q02m.com/servers/better-godot-mcp/setup/)** -- install steps for Claude Code, Codex, Gemini CLI, Cursor, Windsurf, and `mcp.json`.\n\n**Install with AI agent** -- paste this to your AI coding agent:\n\n> Install MCP server `better-godot-mcp` following the steps at\n> https://raw.githubusercontent.com/n24q02m/claude-plugins/main/plugins/better-godot-mcp/setup-with-agent.md\n\n## Tools\n\n| Tool | Actions | Description |\n|:-----|:--------|:------------|\n| `project` | `info`, `version`, `run`, `stop`, `settings_get`, `settings_set`, `export` | Project metadata, run/stop, and settings |\n| `scenes` | `create`, `list`, `info`, `delete`, `duplicate`, `set_main` | Scene file management |\n| `nodes` | `add`, `remove`, `rename`, `list`, `set_property`, `get_property` | Scene tree node manipulation |\n| `scripts` | `create`, `read`, `write`, `attach`, `list`, `delete` | GDScript file CRUD |\n| `editor` | `launch`, `status` | Launch Godot editor and check status |\n| `config` | `status`, `set`, `detect_godot`, `check` | Server configuration and environment detection |\n| `resources` | `list`, `info`, `delete`, `import_config` | Resource file management |\n| `input_map` | `list`, `add_action`, `remove_action`, `add_event` | Input action and event mapping |\n| `signals` | `list`, `connect`, `disconnect` | Signal connections |\n| `animation` | `create_player`, `add_animation`, `add_track`, `add_keyframe`, `list` | Animation players and tracks |\n| `tilemap` | `create_tileset`, `add_source`, `set_tile`, `paint`, `list` | TileMap and TileSet management |\n| `shader` | `create`, `read`, `write`, `get_params`, `list` | Shader file CRUD with Godot 4 syntax |\n| `physics` | `layers`, `collision_setup`, `body_config`, `set_layer_name` | Collision layers and physics bodies |\n| `audio` | `list_buses`, `add_bus`, `add_effect`, `create_stream` | Audio bus and effect management |\n| `navigation` | `create_region`, `add_agent`, `add_obstacle` | Navigation regions, agents, and obstacles |\n| `ui` | `create_control`, `set_theme`, `layout`, `list_controls` | UI control creation and theming |\n| `help` | - | Get full documentation for any tool |\n\n## Comparison\n\nHow better-godot-mcp stacks up against direct competitors in each pillar:\n\n| Capability | better-godot-mcp | Coding-Solo/godot-mcp | bradypp/godot-mcp | tugcantopaloglu/godot-mcp |\n|---|---|---|---|---|\n| Scene file management | Yes (`scenes`: create/list/info/delete/duplicate/set_main) | Yes (create/save) | Yes (create/save) | Yes (create/read/modify) |\n| Node tree manipulation | Yes (`nodes`: add/remove/rename/list/get+set_property) | Partial (add only) | Yes (add/edit/remove) | Yes (add/remove/reparent) |\n| GDScript file CRUD | Yes (`scripts`: create/read/write/attach/list/delete) | No | No | Partial (create from template + runtime eval) |\n| Shader file CRUD | Yes (`shader`: create/read/write/get_params/list) | No | No | Partial (create/read .gdshader) |\n| Animation authoring | Yes (`animation`: player/track/keyframe) | No | No | Yes (player/tween/state machine) |\n| TileMap / TileSet | Yes (`tilemap`: tileset/source/set_tile/paint) | No | No | Yes (TileMapLayer cells) |\n| Physics layers / bodies | Yes (`physics`: layers/collision/body_config) | No | No | Yes (collision/joints/raycast) |\n| Audio bus management | Yes (`audio`: buses/effects/streams) | No | No | Yes (buses/routing/effects) |\n| Navigation setup | Yes (`navigation`: region/agent/obstacle) | No | No | Yes (navigation) |\n| UI control authoring | Yes (`ui`: control/theme/layout) | No | Partial (via add node) | Yes (controls/themes/menus) |\n| Input map editing | Yes (`input_map`: action/event) | No | No | Yes (actions/key bindings) |\n| Signal connections | Yes (`signals`: connect/disconnect/list) | No | No | Yes (connect/emit/await) |\n| Launch editor / run project | Yes (`editor`, `project` run/stop) | Yes | Yes | Yes |\n| Works without running editor | Yes (text-based `.tscn` parsing) | Yes (headless GDScript bridge) | Yes (headless GDScript bridge) | Partial (CLI headless or live TCP socket) |\n| No credentials stored (TC-Local) | Yes | Yes | Yes | Yes |\n| stdio + HTTP transports | Yes (stdio default + `--http`) | No (stdio only) | No (stdio only) | No (stdio only) |\n| Docker image (amd64 + arm64) | Yes | No | No | No |\n| Token-tiered tool descriptions | Yes (compact + on-demand `help`) | No | No | No |\n\n## Configuration\n\nThe Godot binary is auto-detected from common install locations and `PATH`. No environment variables are required for basic usage. Optionally set `GODOT_PROJECT_PATH` and `GODOT_PATH` to override the defaults.\n\n| Variable | Required | Default | Description |\n|:---------|:---------|:--------|:------------|\n| `GODOT_PROJECT_PATH` | No | - | Default project path (tools also accept a `project_path` param) |\n| `GODOT_PATH` | No | Auto-detected | Path to the Godot binary |\n\n### HTTP transport\n\nThe server runs over stdio by default. To serve over Streamable HTTP instead, pass `--http` or set `MCP_TRANSPORT=http` (`TRANSPORT_MODE=http` is also accepted). HTTP mode exposes an unauthenticated `/mcp` endpoint -- there are no credentials to protect, so it is meant for trusted local or self-hosted use.\n\n| Variable | Required | Default | Description |\n|:---------|:---------|:--------|:------------|\n| `MCP_TRANSPORT` | No | `stdio` | Set to `http` for Streamable HTTP transport |\n| `PORT` | No | `0` (auto-assign) | HTTP port (HTTP mode only) |\n| `HOST` | No | Server default | HTTP host (HTTP mode only) |\n\n### Limitations\n\n- Requires a Godot 4.x project structure; a Godot binary is optional for file operations\n- Scene files (`.tscn`) are parsed/modified via text manipulation, not Godot's internal API\n- `run`/`stop`/`export` actions require Godot binary to be installed\n- Docker mode has limited filesystem access (mount your project directory)\n\n## CLI\n\nThe `better-godot-mcp` binary runs the MCP server by default (stdio; add `--http` for Streamable HTTP). It also exposes two diagnostic subcommands for checking your Godot environment before wiring up an MCP client.\n\n| Command | Description |\n|:--------|:------------|\n| `better-godot-mcp` | Start the MCP server (stdio default; `--http` for Streamable HTTP) |\n| `better-godot-mcp detect` | Print the detected Godot binary as JSON (path, version, source); exits non-zero when none is found |\n| `better-godot-mcp doctor` | Health-check the Godot binary and the current project (`GODOT_PROJECT_PATH`, else the working directory) |\n\n```bash\n# Detect the Godot binary (JSON output)\nnpx -y @n24q02m/better-godot-mcp detect\n```\n\n```json\n{\n \"found\": true,\n \"path\": \"/path/to/godot\",\n \"version\": {\n \"major\": 4,\n \"minor\": 7,\n \"patch\": 1,\n \"label\": \"stable.official\",\n \"raw\": \"4.7.1.stable.official\"\n },\n \"source\": \"system\"\n}\n```\n\n```bash\n# Health-check the Godot binary and project\nnpx -y @n24q02m/better-godot-mcp doctor\n```\n\n```text\n[ok] godot binary: /path/to/godot (source: system)\n[ok] godot version: 4.7.1.stable.official\n[warn] project: no project.godot found at /path/to/cwd (set GODOT_PROJECT_PATH)\n```\n\n`detect` exits `1` when no Godot binary is found; `doctor` exits `1` when the binary is missing (a missing `project.godot` is only a warning).\n\n## Security\n\n- **Binary detection** -- Multi-path Godot detection (env, PATH, common locations)\n- **Project validation** -- Verifies project.godot exists before operations\n- **Cross-platform** -- Windows, macOS, Linux path handling\n\n## Build from source\n\n```bash\ngit clone https://github.com/n24q02m/better-godot-mcp.git\ncd better-godot-mcp\nbun install\nbun run dev # stdio mode (default)\nbun run dev:http # Streamable HTTP mode\n```\n\n## Trust model\n\nThis plugin implements **TC-Local** (no auth required -- no credentials stored). See [the trust model reference](https://mcp.n24q02m.com/servers/mcp-core/trust-model/) for full classification.\n\n| Mode | Storage | Encryption | Who can read your data? |\n|---|---|---|---|\n| stdio (default) | N/A (no credentials) | N/A | N/A |\n| HTTP self-host | N/A (no credentials) | N/A | N/A |\n\n## License\n\nApache-2.0 -- See [LICENSE](LICENSE).\n",
"bytes": 15363,
"sha": "955b5492c08ea9f5f4c9941fdb98c7d441d9848c5405c03fb5f29fc0bbe37c80",
"repo_slug": "n24q02m/better-godot-mcp",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/mcp_io_github_n24q02m_better_godot_mcp_135cc6ac/readme"
}