Skip to main content
Glama
OhaoTech

niua-godot-mcp

by OhaoTech

NIUA Godot MCP

v0.1.12

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/NIUAProjects

Claude 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" --write

Starte dein KI-Tool neu.


Related MCP server: godot-mcp-pilot

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

Unable to run Godot

Installiere Godot 4.7 oder setze GODOT_BIN=/pfad/zu/godot in der MCP-Konfiguration

outside allowed project roots

Lege Projekte unter ~/Godot/NIUAProjects (oder dem von dir gewählten Ordner) an

bridge is not reachable

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.js

Weitere 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-game
import { connect } from "niua-godot-mcp/sdk";
const godot = connect({ expectedProjectRoot: "/path/to/project" });
// no tokens to configure

Standard ist core (~52 Tools) – genug für echte Spiele.

  • full – jedes stabile Tool

  • compact – volle Oberfläche hinter 13 Routern

node src/godot-mcp/cli.js setup --client codex --project-root "$HOME/Godot/NIUAProjects" --profile full --write

Experimentelle Tools (Multiplayer, Navigation, Export, …) bleiben verborgen, es sei denn, du setzt NIUA_MCP_EXPERIMENTAL=on. Katalog: tools.md

npm test
npm run godot:mcp:docs

Lizenz

PolyForm Small Business 1.0.0 – kostenlos für Einzelpersonen und Organisationen mit ~100 Personen / ~1 Mio. $ Umsatz. Größere Organisationen: team@ohao.tech

F
license - not found
Not graded
quality - not tested
A
maintenance

Maintenance

Maintainers
Response time
5dRelease cycle
13Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    An 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.
    44
    30
    4
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    An 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.
    33
    21
    2
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    A 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

View all related MCP servers

Related MCP Connectors

  • Hosted MCP server connecting claude.ai, ChatGPT and other AI apps to your own computer

  • An MCP server that gives your AI access to the source code and docs of all public github repos

  • MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/OhaoTech/niua-godot-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server