godot-mcp

Godot MCP

MCP を介した AI による Godot 4 の操作 — シーン操作、3D インポート、GPU パーティクル、 プロシージャルテクスチャ、HTML5 エクスポートに対応しています。決定論的プレイテスト：ゲームの クロックを固定し、アナログ／ジョイパッド／マウス入力を注入して、条件を満たすまで フレームごとに進め、ゲームのライブ状態を構造化 JSON として読み取ります。ゲームビルダー：自然言語でゲームを 説明すると、プレイ可能な GDScript とエクスポート結果を生成します。itch.io と Steam で公開できます。95 以上のツール、77 件のテスト、NSIS デスクトップインストーラーを備えています。

---

クイックインストール

git clone https://github.com/sandraschi/godot-mcp
cd godot-mcp
just bootstrap       # install deps
just serve           # start server (10993)
just web             # open dashboard (10992)

すべての方法（MCPB、開発環境のセットアップ、PC への直接インストール）については、INSTALL.md を参照してください。

---

機能

• ゲームビルダー — design_game -> generate_game_logic -> generate_game_tests -> generate_dialogue -> エクスポート。gdlint + godot --check-only で検証し、LLM が自動修復します。チュートリアル
• プロシージャルテクスチャ — godot_generate_procedural_texture：グラデーション、ノイズ、チェッカー、単色に対応しています。外部アセットは不要です。
• 決定論的プレイテスト — ゲームクロックを固定し、フレームごとに進め、GDScript の条件まで進め、アナログ／ジョイパッド／マウス／テキスト入力を注入します。satelliteoflove/godot-mcp に着想を得た 3 段階の実装です。
• 構造化されたゲーム状態 — godot_state_digest は、_mcp_state() の規約または自動収集されたプロパティを使って、ライブのノード状態を JSON として読み取ります。シーンツリー全体のダンプより低コストです。
• エンジン制御 — 30 個のブリッジツール：STL/GLB/OBJ のインポート、パーティクル、カメラ、ライティング、アニメーション、ビューポートのキャプチャ、入力シミュレーション、シーンノード管理に対応しています。
• アニメーションキーフレームエディター — トラックを個々のキーフレームまで照会し、キーの挿入／削除や補間の設定ができます。
• TileMap/GridMap 編集 — セルデータを直接読み書きします（base64 の .tscn シリアライズを回避します）。
• パフォーマンスプロファイラー — 14 個のエンジンメトリクスを自動サンプリングし、スパイク（2 標準偏差超）を検出します。
• メッシュ検証 — NaN 頂点、縮退三角形、ゼロ法線をスキャンします。
• 3D ガウススプラットのインポート — カスタムのビルボード型ガウスシェーダーを使って .ply および .spz ファイルをインポートします（スプラットごとのスケール、SH DC カラー）。
• 公開 — itch.io Butler と SteamPipe 用の itch_ops および steam_ops の複合ツールを提供します。リポジトリ横断のフリートパイプラインに対応しています。
• GDScript 検証 — LLM による修復を備えた 2 段階検証（gdlint によるスタイル検証 + godot によるコンパイル）を行います。
• プラグインエコシステム — /plugins ページからインストールできるコミュニティ製プラグインが 7 個あります。
• LLM 検出 — GPU を自動で検査し、VRAM の階層に応じてモデルを推奨します。デフォルトは gemma4:12b です。
• サンプルゲーム — AI をテーマにした敵タイプが 10 種登場する Vibecoder Runner。

できること

just gb-demo "A 2D runner where you collect stars and avoid spikes"
just bridge-test                          # check engine connection
just demo-run vibecode                    # play sample game
just gb-preview                           # preview latest HTML5 export

ドキュメント

ドキュメント	内容
インストール	すべてのインストール方法
設定	環境変数、設定項目
ツールリファレンス	90 個以上の MCP ツール
プレイテスト仕様	決定論的プレイテストのアーキテクチャ
デモスクリプト	プレイテスト、プロファイリング、シーン検査、スプラットのインポートのデモ
ゲームビルダーチュートリアル	プロンプトからゲームを作る手順
Godot エコシステム	プラグイン、gdtoolkit、フリートパイプライン
トラブルシューティング	よくある問題
API リファレンス	REST エンドポイント
開発	貢献、ローカル環境のセットアップ

必要条件

• Godot 4.4+（エンジンブリッジツール用） — just install-godot または godotengine.org
• Python 3.13+ + uv — winget install astral-sh.uv
• Bun — winget install oven-sh.bun
• Ollama（任意、ゲームビルダー用） — winget install Ollama.Ollama を実行してから ollama pull gemma4:12b
• Rust（任意、NSIS ビルド用） — rustup.rs

ライセンス

MIT — LICENSE を参照してください。