niua-godot-mcp
NIUA Godot MCP
당신의 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/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" --writeAI 도구를 재시작하세요.
Related MCP server: godot-mcp-pilot
첫 번째 게임
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이 열리고 실제 게임 창이 나타나는 것을 볼 수 있습니다. 에이전트는 수동으로 만든 도구 루프 대신 하나의 간결한 증거 패키지(실행 + 관찰 + 스크린샷 계약)를 받습니다.
문제 해결
문제 | 해결 방법 |
| Godot 4.7을 설치하거나, MCP 설정에서 |
| 프로젝트를 |
| 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-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명 미만 / 약 $100만 수익의 개인 및 조직에게 무료입니다. 더 큰 조직: team@ohao.tech
This server cannot be installed
Maintenance
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
- AlicenseAqualityAmaintenanceA TypeScript MCP server that lets AI assistants interact with the Godot 4.x game engine: not just editing files, but playing the game.3679457MIT
- 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.44304MIT
- AlicenseAqualityBmaintenanceAn 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.33212MIT
- AlicenseNot gradedqualityAmaintenanceA 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
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.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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