niua-godot-mcp
NIUA Godot MCP
Deine KI baut echte Godot-Spiele auf deinem Rechner.
Einmal installieren. Chatten. Godot öffnet sich, Szenen erscheinen, das Spiel läuft. Alles lokal.
60-Sekunden-Installation
Option A — dies in deine KI einfügen (am einfachsten)
In Claude Code, Cursor, Codex oder einen beliebigen Agenten mit Shell-Zugriff kopieren:
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.Starte den KI-Client neu, wenn er dazu auffordert. Fertig.
Option B — selbst machen
Benötigt: 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" --writeStarte dein KI-Tool neu.
Related MCP server: Gear
Erstes Spiel
Frage deine KI:
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.Du solltest sehen, wie Godot sich öffnet und ein echtes Spielfenster erscheint. Der Agent erhält ein kompaktes Beweispaket (Run + Beobachten + Screenshot-Vertrag) anstelle einer selbstgebauten Tool-Schleife.
Wenn etwas schiefgeht
Problem | Lösung |
| Installiere Godot 4.7 oder setze |
| Lege Projekte unter |
| Sage der KI: „Öffne das Projekt mit open_project“ |
Tools fehlen | Starte den KI-Client nach der Installation neu |
Godot hängt an einem Dialog | Drücke Esc in Godot; bitte die KI, die Szene vor dem Ausführen zu speichern |
Gesundheitscheck:
cd niua-godot-mcp && node src/godot-mcp/doctor.jsWeitere Hilfe: Fehlerbehebung
Optional
# 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/Nachdem die KI einmal ein Projekt geöffnet hat:
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 configureStandard ist core (~52 Tools) – genug für echte Spiele.
full– jedes stabile Toolcompact– volle Oberfläche hinter 13 Routern
node src/godot-mcp/cli.js setup --client codex --project-root "$HOME/Godot/NIUAProjects" --profile full --writeExperimentelle Tools (Multiplayer, Navigation, Export, …) bleiben verborgen, es sei denn, du setzt NIUA_MCP_EXPERIMENTAL=on. Katalog: tools.md
npm test
npm run godot:mcp:docsLizenz
PolyForm Small Business 1.0.0 – kostenlos für Einzelpersonen und Organisationen mit ~100 Personen / ~1 Mio. $ Umsatz. Größere Organisationen: team@ohao.tech
This server cannot be deployed
Maintenance
Related MCP Connectors
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.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that gives AI assistants direct control over Godot 4 game development projects. It enables launching the editor, running projects, creating and editing scenes, writing GDScript, and inspecting assets through natural language commands.4415 npm4MIT
- AlicenseAqualityDmaintenanceAn MCP server that enables AI assistants to directly run, inspect, modify, and debug Godot game development projects through 110+ tools covering scenes, scripts, resources, runtime debugging, and asset management.3321 npm2MIT
- AlicenseNot gradedqualityCmaintenanceA security-first MCP server and Godot editor addon enabling AI agents to observe and control Godot games through bounded, permission-gated tools for debugging, input automation, and project editing.MIT
- AlicenseAqualityBmaintenanceAn MCP server that lets AI coding agents work on Godot 4 projects, including reading and editing scenes, writing and validating GDScript, running the game, and capturing screenshots.2550 npmMIT