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が開き、実際のゲームウィンドウが表示されるはずです。エージェントは、自作のツールループの代わりに、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

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