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: godot-mcp-pilot

Первая игра

Спросите ваш ИИ:

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

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