niua-godot-mcp
NIUA Godot MCP
Ваш ИИ создаёт настоящие игры на Godot прямо на вашем компьютере.
Установите один раз. Общайтесь. Godot открывается, сцены появляются, игра запускается. Всё локально.
Установка за 60 секунд
Вариант A — вставьте это в свой ИИ (самый простой)
Скопируйте в Claude Code, Cursor, Codex или любой агент с доступом к shell:
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.Перезапустите ИИ-клиент, когда он об этом попросит. Готово.
Вариант B — сделайте сами
Нужно: Node 20+ · Godot 4.7 · Claude / Cursor / Codex / и т. д.
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" --writeПерезапустите ваш ИИ-инструмент.
Related MCP server: Gear
Первая игра
Спросите ваш ИИ:
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.Вы должны увидеть, как Godot открывается и появляется настоящее игровое окно. Агент получает один компактный пакет подтверждений (контракт «запуск + наблюдение + скриншот») вместо самодельного цикла инструментов.
Если что-то сломалось
Проблема | Решение |
| Установите Godot 4.7 или задайте |
| Поместите проекты в |
| Спросите ИИ: «откройте проект с помощью open_project» |
Tools missing | Перезапустите ИИ-клиент после установки |
Godot stuck on a dialog | Нажмите Esc в Godot; попросите ИИ сохранить сцену перед запуском |
Проверка работоспособности:
cd niua-godot-mcp && node src/godot-mcp/doctor.jsДополнительная помощь: устранение неполадок
Дополнительно
# 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/После того как ИИ один раз откроет проект:
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 configureПо умолчанию используется core (~52 инструмента) — достаточно для настоящих игр.
full— все стабильные инструментыcompact— вся поверхность инструментов через 13 маршрутизаторов
node src/godot-mcp/cli.js setup --client codex --project-root "$HOME/Godot/NIUAProjects" --profile full --writeЭкспериментальные инструменты (мультиплеер, навигация, экспорт, …) остаются скрытыми, пока вы не зададите NIUA_MCP_EXPERIMENTAL=on. Каталог: tools.md
npm test
npm run godot:mcp:docsЛицензия
PolyForm Small Business 1.0.0 — бесплатно для частных лиц и организаций с численностью до ~100 человек / выручкой до ~$1 млн. Для более крупных организаций: 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