youichi-uda/godot-mcp-pro

Godot MCP Pro – AI駆動のGodotエディタブリッジ

何であるか – 大規模言語モデルアシスタント（Claude、Copilot、Cursorなど）がリアルタイムでGodotエディタを制御できる有料アドオン。これはNode.jsで書かれたModel Context Protocol（MCP）サーバーを通じて、WebSocket（デフォルトポート6505）でエディタプラグインと通信することで実現される。サーバーはプロジェクト管理、シーングラフ操作、スクリプティング、エディタUI、入力シミュレーション、実行時インスペクション、アニメーション、物理、エクスポート、テストなど、187のJSON-RPCツールを公開している。

なぜ重要か – エディタAPIをRPC呼び出しとして公開することで、LLMはプロジェクト構造を確認し、ノードを編集し、スクリプトを実行し、スクリーンショットを取得し、入力をシミュレートし、Androidへのデプロイまで可能になる。モデルがファイルを直接読み書きする必要はなく、完全にインタラクティブでコード不要のゲーム開発が実現され、AIは人間のようにエディタ内で反復、テスト、デバッグを行うことができる。

仕組み

1. Godotプラグインのインストール – addons/godot_mcp/をプロジェクトにコピーし、エディタ設定で有効化する。
2. MCPサーバーの実行 – サーバーは有料パッケージでのみ提供される。展開後、npm install && npm run buildでbuild/index.js実行可能ファイルが生成される。
3. AIクライアントの設定 – .mcp.jsonファイルにmcpServers.godot‑mcp‑proエントリを追加し、ビルド済みNodeスクリプトを指定する（必要に応じて--lite、--minimal、--3dフラグでツールセットを制限し、コンテキスト窓が小さいモデルに対応）。
4. 接続 – AIアシスタントはstdio/MCP経由でサーバーと通信。サーバーはWebSocket経由でJSON-RPC呼び出しをGodotプラグインに転送し、要求されたエディタ操作を実行する。
5. 使用 – AI側から187のツールのいずれかを呼び出すことができる。例：project info、node add --type CharacterBody3D --name Player、simulate_key "Space"、run_test_scenario、deploy_to_android。

モードとツール数制限

モード	公開されるツール	一般的なクライアント
フル（デフォルト）	187	Claude Code、VS Code Copilot、Cursor（ハード制限なし）
3D (--3d)	100	3Dツールが必要だが100ツールまでに制限されるクライアント
ライト (--lite)	88	Windsurf、JetBrains Junie、Gemini CLI
ミニマル (--minimal)	35	OpenCode、コンテキスト窓が非常に小さいローカルLLM

主な機能

• Undo/Redo統合 – すべての変更はCtrl+Zで元に戻せる。
• スマートな型パース – "Vector2(100,200)"や"#ff0000"のような文字列が自動的にGodot型に変換される。
• 自動再接続＆ハートビート – リソースフルな接続処理。
• 役立つエラーメッセージ – RPCエラー応答に次のステップの提案が含まれる。
• CLIフォールバック – コマンドラインクライアント（cli.js）でMCPなしでも同じツールを駆動可能。ターミナル専用環境に有用。

インストールチェックリスト

1. server/フォルダを入手するため、フルパッケージ（Buy Me a Coffeeまたはitch.io）を購入する。
2. addons/godot_mcp/ディレクトリをGodotプロジェクトにコピーし、プラグインを有効化する。
3. Nodeサーバーをビルドする（npm install && npm run build）。
4. .mcp.jsonに適切なエントリを追加する（必要に応じてモードフラグを選択）。
5. Godotを起動し、エディタを開いたままにして、AIアシスタントを実行する。

ライセンスと配布 – この公開リポジトリ内のプラグインコードは無料でオープンソース。MCPサーバーバイナリとフル機能は有料パッケージでのみ配布。リポジトリは明確にserver/ディレクトリが公開リポジトリから除外されていると記載している。

---

Godot MCP Pro は本物のAI中心のツールであり、大規模言語モデルとGodotゲームエンジンを橋渡しし、Godotプロジェクトのほぼすべての側面に対してプログラム的でリアルタイムな制御を開発者（またはAIアシスタント）に提供する。