Godot MCP Enhanced
Godot MCP Enhanced reads, edits, runs and verifies Godot 4.5 to 4.7 projects: scenes, scripts, UI and tests with path protection.
- 104 ★ on the repository
- Last commit
Broad access
Why this level
- The server writes and runs GDScript, and a game script has full system access.
- Write operations change project files, and deletion needs confirmation.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/godot-mcp-enhancedDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The server writes and runs GDScript, and a game script has full system access.
- Write operations change project files, and deletion needs confirmation.
This is third-party code. Review the repository files before installing.
What it does
The server gives an agent a tool layer over Godot: scenes, scripts, UI, animation, physics, particles, navigation, audio, tests, export and parametric 3D assets. The README version has 46 tools and 272 actions. Three layers (headless, editor and a bridge to the running game) mean the editor need not open at all: the agent creates a project, writes scripts, runs the game, takes a screenshot and checks the result. The focus is verification: `run_and_verify` analyzes errors, `validate_scripts` compiles scripts, `qa` runs deterministic test suites with a fixed random seed and `verify_delivery` checks the scene and performance. Editor actions land in the native Godot undo stack. Tool descriptions are in Chinese and the README also exists in English.
Who it is for. Godot game developers who hand routine work to an agent and want a verifiable loop: edit, run, check.
Good fit when
- An agent creates a 2048 or snake prototype and runs its tests.
- A script is checked by compilation after an edit rather than by eye.
- A bug is reproduced deterministically: the same input and seed give the same result.
- The assistant takes a screenshot of the game and shows its current look.
- You want to keep a working project and undo a bad edit with one `Ctrl+Z`.
Not a fit when
- You need full isolation: the sandbox guards against mistakes and is not an unbreakable boundary.
- The game runs on a Godot older than 4.5.
- Tool descriptions must be in English.
Example request
Create a 2048 project from the template, run its tests and show a screenshot of the game.MCP
- Transport
- stdio
- Authentication
- not required
Environment variables
ALLOWED_PROJECT_PATHS- Allowlist of project paths; access is denied by default
GODOT_MCP_SANDBOX- The `disabled` value turns off script scanning; development only
GODOT_MCP_ALLOW_UNSAFE- Allows unsafe operations; set `false` for isolation
Limitations
Node.js 18 or newer and Godot 4.x (tested from 4.6) are required. `run_tests` needs the GUT addon. The protection (path allowlist, dangerous-call scanning, delete confirmation) prevents mistakes, but GDScript has full system access, and the author advises a container or VM for real isolation. On startup the server queries the npm registry for updates. The license is MIT, with copyright from the upstream Coding-Solo/godot-mcp.
How to disable. First `npx godot-mcp-enhanced uninstall --dry-run`, then `--yes`: it removes client registrations and project traces. With `--purge`, `~/.godot-mcp/` goes too.
FAQ
How do I connect it to Claude Code?
With `claude mcp add -s user godot -- npx -y godot-mcp-enhanced`. A single setup for 15 clients: `npx godot-mcp-enhanced setup`.
Do I need to install Godot separately?
No, `npx godot-mcp-enhanced install` downloads the official build with SHA512 verification into `~/.godot-mcp/godot/<version>/` and adds it to the path list.
Which game templates exist?
Three: `2048`, `snake` and `breakout`. `npx godot-mcp-enhanced init my-game --template=2048` creates a project with a demo, a GDD document and test suites.
How does it differ from Coding-Solo/godot-mcp?
The author gives a migration guide: capabilities are kept, and three architecture layers, protection, quality gates and a version compatibility matrix are added.
How do I remove the server and its traces from a project?
`npx godot-mcp-enhanced uninstall --dry-run` shows what will be removed, then `--yes` deletes client registrations and project references. `--purge` also wipes `~/.godot-mcp/` with the downloaded Godot.
Discussion
No questions or reviews yet.
Related
MCP serversAn MCP server with 157 tools for Godot 4: the agent edits scenes and projects, runs the game, changes live nodes and writes GDScript and .NET scripts
An addon makes the Godot 4.2 and newer editor an MCP server with over 150 operations and a tool set that grows on request.
MCP for the Godot editor: an agent edits scenes, runs the game, freezes time and verifies its own work by playtest
An MCP server and plugin for Godot 4.4+: the agent edits scenes and scripts in the editor, runs the game and reads errors
An MCP server for the Godot engine: launch the editor, run projects and edit scenes from an agent
An MCP server for Godot 4 that runs inside the editor: the agent edits scenes, nodes and scripts, runs the project and reads the debugger, no Node.js
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Godot MCP Enhanced (this card) | no | not required | 104 | |
| Godot MCP | no | not required | 6,620 | a baseline server for scenes and running; Enhanced adds three layers, path protection and deterministic verification |
| Godot MCP Native | no | not required | 874 | works as a built-in Godot layer; Enhanced combines headless, editor and a game bridge |
README in short
An enhanced Godot MCP with three layers, path protection and a verification pipeline. It includes agent skills, game templates and `qa`, `init`, `gif` and `web` commands for checks and browser publishing.