Godot MCP Pro

Godot 4エディタ用AI搭載ツール168選 — AIアシスタント（Claude、Cursor、Cline、Copilot）をGodotに接続し、自然言語でゲームを構築しましょう。

仕組み

5分以内にAIアシスタントをGodotに接続します。

1. プラグインのインストール

addons/godot_mcp/ をGodotプロジェクトにコピーします。プロジェクト > プロジェクト設定 > プラグイン で有効にします。プラグインはエディタ内で自動的にWebSocketサーバーを起動します。

2. MCPサーバーのビルド

cd server
npm install && npm run build

これにより、AIクライアントとGodotプラグインを橋渡しするTypeScript MCPサーバーがコンパイルされます。

3. AIによる構築を開始

AIクライアントのMCP設定にサーバーを追加します。Godotを開くと、AIアシスタントが168個のツールにリアルタイムでアクセスできるようになり、シーンの作成、スクリプトの編集、入力のシミュレーション、実行中のゲームの分析が可能になります。

MCPクライアント設定

Claude Code / Claude Desktop

.claude/mcp.json に追加します：

{
  "mcpServers": {
    "godot": {
      "command": "node",
      "args": ["/absolute/path/to/server/dist/index.js"]
    }
  }
}

VS Code / Cursor

.vscode/mcp.json に追加します：

{
  "servers": {
    "godot": {
      "command": "node",
      "args": ["./server/dist/index.js"]
    }
  }
}

stdio MCPクライアント

node server/dist/index.js

サーバーはMCPプロトコルを使用してstdio（stdin/stdout）経由で通信します。

自動セットアップ（推奨）

cd server
npm run run

これにより、以下の操作が自動的に行われます：

MCPサーバーのビルド
親フォルダ（または GODOT_PROJECT_PATH）内の project.godot の検出
アドオンを addons/godot_mcp に同期
project.godot でプラグインを有効化
MCP設定ファイルの作成
AIコンテキストファイルの同期

ツールカテゴリ

#	カテゴリ	ツール数	ハイライト
1	プロジェクト	7	設定の読み書き、UID変換
2	シーン	9	作成、開く、再生、停止、インスタンス化、保存
3	ノード	14	UndoRedo付きの追加/削除/名前変更/移動、シグナル、グループ
4	スクリプト	8	CRUD、アタッチ、検証、行番号付き検索
5	エディタ	10	スクリーンショット、GDScript実行、エラーログ、リロード
6	入力	7	キーボード、マウス、アクションシミュレーション、シーケンス
7	ランタイム	19	ゲーム検査、フレームキャプチャ、記録/再生、UI
8	アニメーション	6	CRUD、トラック、キーフレーム
9	AnimationTree	8	ステートマシン、遷移、ブレンドツリー
10	TileMap	6	セル操作（Godot 4.3+用TileMapLayer）
11	3Dシーン	6	メッシュプリミティブ、.glbインポート、照明プリセット、PBR
12	物理	6	自動2D/3D衝突判定、レイキャスト、レイヤー
13	パーティクル	5	GPUパーティクル + 炎/煙/雨/雪/火花のプリセット
14	ナビゲーション	6	リージョン、エージェント、ベイク、パスファインディング
15	オーディオ	6	プレイヤー（自動2D/3D）、バスエフェクトチェーン
16	テーマ/UI	6	StyleBoxFlat、色/定数/フォントのオーバーライド
17	シェーダー	6	テンプレート（canvas_item, spatial, particles, sky）
18	リソース	6	.tres CRUD、オートロード管理
19	バッチ	8	型による検索、一括設定、依存関係分析
20	テスト	6	自動化シナリオ、アサーション、ストレステスト
21	分析	4	シーンの複雑さ、シグナルフロー、未使用リソース
22	プロファイリング	2	FPS、メモリ、物理、レンダリングモニター
23	エクスポート	3	プリセット一覧、ビルドコマンド
	合計	168	+ 4個のコア接続ツール

主な機能

🧠 スマートな型解析

複雑なオブジェクトを手動で構築する必要はありません。プロパティ値は自動変換されます：

"Vector2(100, 200)"  → Vector2(100, 200)
"Color(1, 0, 0)"    → Color(1, 0, 0)
"#ff0000"            → Color(1, 0, 0)
"Color.RED"          → Color(1, 0, 0)
"true"               → true
"42"                 → 42

♻️ すべての変更に対する元に戻す/やり直し

add_node、delete_node、update_property、rename_node、move_node のすべてがGodotのUndoRedoシステムを経由します。ユーザーはAIの操作をいつでも Ctrl+Z で取り消せます。

🎯 自動2D/3D検出

物理ボディ、衝突形状、オーディオプレイヤー、パーティクル、ナビゲーションノードは、親が2Dか3Dかを自動的に検出し、常に適切な型が作成されます。

🔥 組み込みプリセット

照明: 太陽、屋内、ドラマチック、スポットライト
パーティクル: 炎、煙、雨、雪、火花
シェーダー: canvas_item, spatial, particles, skyテンプレート
オーディオエフェクト: リバーブ、ディレイ、コンプレッサー、EQ、ディストーション、コーラス、フェイザー

クイック例

AI: godot_connect
AI: create_scene path="res://scenes/level.tscn" rootType="Node2D"
AI: add_node type="CharacterBody2D" name="Player" parentPath="."
AI: add_node type="Sprite2D" name="Sprite" parentPath="Player"
AI: update_property path="Player/Sprite" property="texture" value="res://icon.svg"
AI: setup_collision path="Player" shapeType="rectangle" size="Vector2(32, 32)"
AI: create_script path="res://scripts/player.gd" content="extends CharacterBody2D..."
AI: attach_script nodePath="Player" scriptPath="res://scripts/player.gd"
AI: save_scene
AI: play_scene
AI: simulate_key key="Space"
AI: get_game_screenshot
AI: stop_scene

アーキテクチャ

server/src/
├── index.ts           TypeScript MCP server (stdio transport)
├── toolCatalog.ts     168 tool definitions with input schemas
└── godotBridge.ts     WebSocket client → Godot editor

addons/godot_mcp/
├── plugin.gd          Plugin entry point
├── websocket_server.gd Local WebSocket server (port 6505)
├── command_router.gd  Loads 20 handler modules, dispatches commands
└── commands/
    ├── base_commands.gd        Shared utilities (type parser, undo, I/O)
    ├── type_parser.gd          Smart string→Godot type conversion
    ├── undo_helper.gd          UndoRedo wrapper
    ├── core_commands.gd        Project, scene, node, script, editor (47 handlers)
    ├── editor_commands.gd      Screenshots, execute script (4)
    ├── input_commands.gd       Input simulation (7)
    ├── runtime_commands.gd     Game inspection & UI (15)
    ├── animation_commands.gd   Animation CRUD (6)
    ├── animation_tree_commands.gd  State machine & blend tree (8)
    ├── tilemap_commands.gd     Tile operations (6)
    ├── scene3d_commands.gd     3D scene building (6)
    ├── physics_commands.gd     Physics & collision (6)
    ├── particles_commands.gd   GPU particles + presets (5)
    ├── navigation_commands.gd  Nav regions & pathfinding (6)
    ├── audio_commands.gd       Audio players & bus effects (6)
    ├── theme_commands.gd       Theme & UI styling (6)
    ├── shader_commands.gd      Shader management (4)
    ├── resource_commands.gd    Resource & autoload (6)
    ├── batch_commands.gd       Batch operations (8)
    ├── testing_commands.gd     Testing & QA (5)
    ├── analysis_commands.gd    Code analysis (4)
    ├── profiling_commands.gd   Performance profiling (2)
    └── export_commands.gd      Export management (3)

ブリッジプロトコル

WebSocket経由のJSON-RPC 2.0 (ws://127.0.0.1:6505)：

→ { "jsonrpc": "2.0", "id": 1, "method": "add_node", "params": { "type": "Sprite2D", "name": "Player" } }
← { "jsonrpc": "2.0", "id": 1, "result": { "tool": "add_node", "data": { "path": "/root/Main/Player" } } }

ブリッジURLのオーバーライド: GODOT_WS_URL=ws://127.0.0.1:6505 node server/dist/index.js

要件

Godot 4.2+ (TileMapLayerには4.3+を推奨)
Node.js 18+
MCP互換のAIクライアント

AIエージェントコンテキストファイル

Godotプロジェクトにデプロイされると、これらのコンテキストファイルはAIアシスタントが利用可能なツールを理解するのに役立ちます：

ファイル	目的	利用者
`addons/godot_mcp/skills.md`	ワークフローを含む168個のツールリファレンス	すべてのAIエージェント
`AGENTS.md`	アーキテクチャ + 機能の概要	Codex, Gemini, エージェント
`CLAUDE.md`	クイックリファレンス + ビルドコマンド	Claude Code
`.github/copilot-instructions.md`	Copilot固有の指示	GitHub Copilot

Godot MCP Bridge