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: 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が開き、実際のゲームウィンドウが表示されるはずです。エージェントは、自作のツールループの代わりに、1つのコンパクトなエビデンスパック(実行+観察+スクリーンショット契約)を受け取ります。


問題が発生した場合

問題

対処方法

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

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