Skip to main content
Glama
OhaoTech

niua-godot-mcp

by OhaoTech

NIUA Godot MCP

v0.1.12

Ваш ИИ создаёт настоящие игры на 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/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

Перезапустите ваш ИИ-инструмент.


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 открывается и появляется настоящее игровое окно. Агент получает один компактный пакет подтверждений (контракт «запуск + наблюдение + скриншот») вместо самодельного цикла инструментов.


Если что-то сломалось

Проблема

Решение

Unable to run Godot

Установите Godot 4.7 или задайте GODOT_BIN=/path/to/godot в конфигурации MCP

outside allowed project roots

Поместите проекты в ~/Godot/NIUAProjects (или в выбранную вами папку)

bridge is not reachable

Спросите ИИ: «откройте проект с помощью 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-game
import { 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

Related MCP Connectors

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
    15 npm
    4
    MIT
  • A
    license
    A
    quality
    D
    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 npm
    2
    MIT
  • A
    license
    Not graded
    quality
    C
    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
  • A
    license
    A
    quality
    B
    maintenance
    An 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.
    25
    50 npm
    MIT