better-godot-mcp
About
Godot Engine integration: 17 tools for game development
Details
- Author
- n24q02m
- Categories
- Developer Tools, Other
Jump to
Setup
Install better-godot-mcp in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/n24q02m/better-godot-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
mcp-name: io.github.n24q02m/better-godot-mcp
Composite MCP server for Godot Engine -- 17 composite tools for AI-assisted game development.
- Features
- Install
- Smithery
- Documentation
- Tools
- Comparison
- Configuration
- CLI
- Security
- Build from source
- Trust model
- License
- 17 composite mega-tools-- scene, node, script, shader, animation, tilemap, physics, audio, navigation, UI, and more
- Full scene control-- create, parse, and modify.tscnfiles directly without Godot running
- GDScript CRUD-- create, read, write, and attach scripts in a single call
- Tiered token optimization-- compressed descriptions + on-demandhelptool
Runs overstdioby 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; onlyrun/stop/exportandeditoractions 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.
Add to your client's MCP config (Claude Code, Cursor, Windsurf, Codex,mcp.json):
{ "mcpServers": { "better-godot-mcp": { "command": "npx", "args": ["-y", "@n24q02m/better-godot-mcp"], "env": { "GODOT_PROJECT_PATH": "/path/to/your/godot/project" } } } }
GODOT_PROJECT_PATHis optional -- every tool also accepts aproject_pathargument per call.
docker run -i --rm -v /path/to/your/godot/project:/project n24q02m/better-godot-mcp
The image is published foramd64andarm64. Mount your project directory so the server can read and write scene, script, and resource files.
better-godot-mcp ships asmithery.yamlso it can be discovered and deployed throughSmithery. Smithery launches the server overstdiovianpx -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.
Full setup guide atmcp.n24q02m.com/servers/better-godot-mcp/setup/-- install steps for Claude Code, Codex, Gemini CLI, Cursor, Windsurf, andmcp.json.
Install with AI agent-- paste this to your AI coding agent:
Install MCP serverbetter-godot-mcpfollowing the steps athttps://raw.githubusercontent.com/n24q02m/claude-plugins/main/plugins/better-godot-mcp/setup-with-agent.md
How better-godot-mcp stacks up against direct competitors in each pillar:
The Godot binary is auto-detected from common install locations andPATH. No environment variables are required for basic usage. Optionally setGODOT_PROJECT_PATHandGODOT_PATHto override the defaults.
The server runs over stdio by default. To serve over Streamable HTTP instead, pass--httpor setMCP_TRANSPORT=http(TRANSPORT_MODE=httpis also accepted). HTTP mode exposes an unauthenticated/mcpendpoint -- there are no credentials to protect, so it is meant for trusted local or self-hosted use.
- Requires a Godot 4.x project structure; a Godot binary is optional for file operations
- Scene files (.tscn) are parsed/modified via text manipulation, not Godot's internal API
- run/stop/exportactions require Godot binary to be installed
- Docker mode has limited filesystem access (mount your project directory)
Thebetter-godot-mcpbinary runs the MCP server by default (stdio; add--httpfor Streamable HTTP). It also exposes two diagnostic subcommands for checking your Godot environment before wiring up an MCP client.
# Detect the Godot binary (JSON output) npx -y @n24q02m/better-godot-mcp detect
{ "found": true, "path": "/path/to/godot", "version": { "major": 4, "minor": 7, "patch": 1, "label": "stable.official", "raw": "4.7.1.stable.official" }, "source": "system" }
# Health-check the Godot binary and project npx -y @n24q02m/better-godot-mcp doctor
[ok] godot binary: /path/to/godot (source: system) [ok] godot version: 4.7.1.stable.official [warn] project: no project.godot found at /path/to/cwd (set GODOT_PROJECT_PATH)
detectexits1when no Godot binary is found;doctorexits1when the binary is missing (a missingproject.godotis only a warning).
- Binary detection-- Multi-path Godot detection (env, PATH, common locations)
- Project validation-- Verifies project.godot exists before operations
- Cross-platform-- Windows, macOS, Linux path handling
git clone https://github.com/n24q02m/better-godot-mcp.git cd better-godot-mcp bun install bun run dev # stdio mode (default) bun run dev:http # Streamable HTTP mode
This plugin implementsTC-Local(no auth required -- no credentials stored). Seethe trust model referencefor full classification.
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
An MCP server for Unity, enabling AI assistants to interact with projects in real-time, access scene data, and execute code.
Fennara MCP connects AI agents like Codex, Cursor, Claude Code, and Claude Desktop to Godot-aware tools for real Godot projects. It focuses on feedback from Godot: GDScript diagnostics, scene validation, runtime errors, scene inspection, node properties, screenshots, SemanticSearch, and patch-and-rerun workflows.
The intelligent MCP server for AI-assisted Godot 4 development. 35 tools for spatial intelligence, code understanding, flow tracing, and visual debugging. 22 free, full suite $19.
A secure, 100% native GDScript Server-Sent Events (SSE) server bridging Claude, Cursor, and Windsurf directly to Godot 4.x scene trees. No Node.js or C# dependencies required.
An MCP server that helps coding agents to work with Minecraft mod development
Free, open-source MCP server for Roblox Studio. Push-based SSE transport, editor-safe script edits, 29 token-lean tools.
Connect AI coding agents to a live Roblox Studio session.
A template project demonstrating interaction between a TypeScript-based MCP server and a Unity client.
An MCP server to help AI assistants to answer questions and generate AccelByte Extend SDK code more effectively .
Local stdio MCP server that lets AI coding agents read and maintain structured architecture, rules, and decisions directly from your repository.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
