hi-godot/godot-ai

解決する問題

Godot AI を使用すると、AI アシスタント（Claude Code、Claude Desktop、Cursor など）が、動作中の Godot ゲームエンジンエディタと直接対話できます。これにより、ユーザーが手動でコードをコピー＆ペーストしたり、手動でシーンを設定したりする必要がなくなり、AI がリアルタイムでシーンの構築、ノードの編集、ゲーム環境の設定を行うことができます。

仕組み

このプロジェクトは Model Context Protocol (MCP) を実装し、AI クライアントと Godot エディタの間のブリッジとして機能します。通信フローは次のとおりです。

1. MCP クライアント: AI アシスタント（例: Claude）がリクエストを送信します。
2. ブリッジ: Python サーバー（godot-ai attach）が stdio を介してリクエストを処理します。
3. Godot エディタ: Godot エディタ内のプラグインが認証された WebSocket 接続を受信し、操作を実行します。

スクリプト編集、シグナル配線、UI 設定など、エディタを操作するための 46 のツールと 120 以上の操作を提供します。

対象読者

Godot Engine (4.7+) を使用するゲーム開発者で、LLM を活用して、シーンの構築、マテリアルの設定、プレイヤーコントローラのセットアップなど、エディタベースのゲーム開発における反復的なタスクを自動化したいと考えている方。

ハイライト

• 深いエディタ統合: シーンの構築、ノードの編集、シグナルの配線、UI、マテリアル、アニメーション、パーティクルの設定が可能です。
• 幅広いクライアントサポート: Claude Code、Claude Desktop、Codex、Cursor、VS Code などと互換性があります。
• 幅広いスクリプトサポート: パース検証とホットリロードを備えた GDScript の完全サポート。C# はテキストのみのサポート。
• 安全な通信: 独立したローテーション機能と認証された HTTP/WebSocket 接続を使用して、ローカルループバックのセキュリティを確保します。

まとめ

MCP 互換の AI アシスタントを Godot エディタに接続するブリッジで、AI がエンジン内で直接シーンを構築したり、ノードを編集したり、スクリプトを記述したりできるようにします。

タイトル

AI アシスタントが Godot ゲームエンジンエディタを直接操作できるようにする MCP ベースのブリッジ