niua-godot-mcp
NIUA Godot MCP
Tu IA construye juegos reales de Godot en tu máquina.
Instala una vez. Chatea. Godot se abre, aparecen escenas, el juego se ejecuta. Todo local.
Instalación en 60 segundos
Opción A — pégale esto a tu IA (la más fácil)
Copia en Claude Code, Cursor, Codex o cualquier agente con acceso a la terminal:
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.Reinicia el cliente de IA cuando te lo indique. Listo.
Opción B — hazlo tú mismo
Necesitas: 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" --writeReinicia tu herramienta de IA.
Related MCP server: Gear
Primer juego
Pregúntale a tu IA:
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.Deberías ver que Godot se abre y aparece una ventana de juego real. El agente recibe un paquete de evidencia compacto (ejecutar + observar + captura de pantalla) en lugar de un bucle de herramientas hecho a mano.
Si algo falla
Problema | Solución |
| Instala Godot 4.7, o establece |
| Coloca los proyectos dentro de |
| Pídele a la IA: «abre el proyecto con open_project» |
Tools missing | Reinicia el cliente de IA después de la instalación |
Godot atascado en un diálogo | Pulsa Esc en Godot; pídele a la IA que guarde la escena antes de ejecutar |
Verificación de estado:
cd niua-godot-mcp && node src/godot-mcp/doctor.jsMás ayuda: troubleshooting
Opcional
# 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/Después de que la IA haya abierto un proyecto una vez:
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 configureEl valor por defecto es core (~52 herramientas) — suficiente para juegos reales.
full— todas las herramientas establescompact— superficie completa detrás de 13 enrutadores
node src/godot-mcp/cli.js setup --client codex --project-root "$HOME/Godot/NIUAProjects" --profile full --writeLas herramientas experimentales (multijugador, navegación, exportación, …) permanecen ocultas a menos que establezcas NIUA_MCP_EXPERIMENTAL=on. Catálogo: tools.md
npm test
npm run godot:mcp:docsLicencia
PolyForm Small Business 1.0.0 — gratuita para personas y organizaciones con menos de ~100 personas / ~$1M de ingresos. Organizaciones más grandes: 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