Skip to main content
Glama
OhaoTech

niua-godot-mcp

by OhaoTech

NIUA Godot MCP

v0.1.12

당신의 AI가 당신의 컴퓨터에서 실제 Godot 게임을 만듭니다.

한 번 설치하세요. 대화하세요. Godot이 열리고, 씬이 나타나며, 게임이 실행됩니다. 모두 로컬에서 이루어집니다.


60초 설치

옵션 A — AI에 붙여넣기 (가장 쉬움)

Claude Code, Cursor, Codex 또는 셸 접근이 가능한 모든 에이전트에 복사하세요:

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.

설치 후 AI 클라이언트를 재시작하세요. 완료입니다.

옵션 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

AI 도구를 재시작하세요.


Related MCP server: Gear

첫 번째 게임

AI에게 물어보세요:

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을 설치하거나, MCP 설정에서 GODOT_BIN=/path/to/godot을 설정하세요

outside allowed project roots

프로젝트를 ~/Godot/NIUAProjects(또는 선택한 폴더) 아래에 두세요

bridge is not reachable

AI에게 "open_project로 프로젝트 열기"를 요청하세요

도구 누락

설치 후 AI 클라이언트를 재시작하세요

Godot이 대화상자에서 멈춤

Godot에서 Esc를 누르고, AI에게 실행 전 씬을 저장하도록 요청하세요

상태 확인:

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/

AI가 프로젝트를 한 번 연 후:

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명 미만 / 약 $100만 수익의 개인 및 조직에게 무료입니다. 더 큰 조직: 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