Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@niua-godot-mcp create a new Godot project called 'Platformer'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Your AI builds real Godot games on your machine.
Install once. Chat. Godot opens, scenes appear, the game runs. All local.
Copy into Claude Code, Cursor, Codex, or any agent with shell access:
Install NIUA Godot MCP for me.
Follow: https://raw.githubusercontent.com/OhaoTech/niua-godot-mcp/main/docs/godot-mcp/INSTALL-BY-AGENT.md
Ask before writing any config. Then call get_godot_version.Restart the AI client when it says so. Done.
Need: Node 20+ · Godot 4.7 · Claude / Cursor / Codex / etc.
git clone https://github.com/OhaoTech/niua-godot-mcp.git
cd niua-godot-mcp
mkdir -p ~/Godot/NIUAProjectsClaude Code:
claude mcp add niua-godot -s user \
--env GODOT_MCP_ALLOWED_PROJECT_ROOTS="$HOME/Godot/NIUAProjects" \
-- node "$(pwd)/src/godot-mcp/cli.js"Codex / Claude Desktop / Cursor:
# preview
node src/godot-mcp/cli.js setup --client codex --project-root "$HOME/Godot/NIUAProjects"
# write (use --client claude or --client generic for others)
node src/godot-mcp/cli.js setup --client codex --project-root "$HOME/Godot/NIUAProjects" --writeRestart your AI tool.
Related MCP server: Gear
Ask your AI:
Create a Godot project at ~/Godot/NIUAProjects/first-game.
Build a 3D scene with a ground, a cube, a camera, and a light.
Save it, set it as main, then call run_playtest_evidence and tell me the evidence claims.You should see Godot open and a real game window. The agent gets one compact evidence pack (run + observe + screenshot contract) instead of a hand-rolled tool loop.
Problem | Fix |
| Install Godot 4.7, or set |
| Put projects under |
| Ask the AI: “open the project with open_project” |
Tools missing | Restart the AI client after install |
Godot stuck on a dialog | Press Esc in Godot; ask the AI to save the scene before run |
Health check:
cd niua-godot-mcp && node src/godot-mcp/doctor.jsMore help: troubleshooting
# Claude Code
mkdir -p ~/.claude/skills && cp -r skills/niua-godot ~/.claude/skills/
# Codex / agents
mkdir -p ~/.agents/skills && cp -r skills/niua-godot ~/.agents/skills/After the AI has opened a project once:
node examples/sdk-quickstart.mjs ~/Godot/NIUAProjects/first-gameimport { connect } from "niua-godot-mcp/sdk";
const godot = connect({ expectedProjectRoot: "/path/to/project" });
// no tokens to configureDefault is core (~52 tools) — enough for real games.
full — every stable tool
compact — full surface behind 13 routers
node src/godot-mcp/cli.js setup --client codex --project-root "$HOME/Godot/NIUAProjects" --profile full --writeExperimental tools (multiplayer, nav, export, …) stay hidden unless you set NIUA_MCP_EXPERIMENTAL=on. Catalog: tools.md
npm test
npm run godot:mcp:docsPolyForm Small Business 1.0.0 — free for individuals and orgs under ~100 people / ~$1M revenue. Larger orgs: team@ohao.tech
This server cannot be deployed
An MCP server that gives your AI access to the source code and docs of all public github repos
A registry of AI agent tools — MCP servers, APIs, CLIs, SDKs — kept current by automated ingestion.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Generate game-ready 3D models, textures, and audio from natural language, over MCP.
