tugcantopaloglu/godot-mcp

解決する課題

Godot MCPは、AIアシスタントがGodotゲームエンジンをプログラムで制御できるようにします。LLMのコード生成能力と、ゲームプロジェクトの実際の実行、検査、修正の間のギャップを埋め、AIがリアルタイムでゲームの構築、デバッグ、テストを行えるようにします。

仕組み

このプロジェクトは、Model Context Protocol (MCP) サーバーを実装し、157種類の専門的なツールをAIアシスタントに公開します。これらのツールにより、AIは主に2つのモードでGodotと対話できます。

1. ヘッドレスシーン操作: ゲームを実行することなく、.tscn ファイルの修正、リソースの作成、プロジェクト設定の管理を行います。
2. ランタイムインタラクション: TCPベースのサーバーを使用して、ゲーム実行中にGDScriptコード (game_eval) の実行、ノードプロパティの検査、シーンツリーの操作、ユーザー入力（キーボード、マウス、ゲームパッド）のシミュレーションを行います。

GDScriptと.NET/C#プロジェクトの両方をサポートしており、スクリプトの検証やプロジェクトの足場構築ツールも提供します。

対象ユーザー

Godot 4.4+ を使用するゲーム開発者で、AIエージェントを活用してゲーム制作の自動化、ランタイムデバッグ、複雑なシーン構造やロジックの生成を行いたい方。

ハイライト

• 広範なツールセット: 3D/2Dレンダリング、物理、オーディオからネットワーク、UI制御までを網羅する157種類のツール。
• ランタイム実行: ゲーム実行中に任意のGDScriptコードを実行し、非同期操作を待機する機能。
• 詳細なイントロスペクション: ランタイムにおける完全なノード検査、プロパティの読み書き、シグナル管理。
• C# サポート: .NETプロジェクトの足場構築およびC#スクリプト生成に対するファーストクラスのサポート。
• ヘッドレス編集: エディタを起動せずにシーンファイルやプロジェクト設定を解析・修正する機能。
• 統合診断: GDScriptの構文や型エラーをヘッドレスで検証するためのツール。