godot-ai

# Godot AI Godot AIは、Claude Code、Claude Desktop、Codex、Hermes AgentなどのMCPクライアントを、稼働中のGodotエディタに接続します。46のツールと120以上の操作を提供し、AIアシスタントがシーンの構築、ノードやスクリプトの編集、シグナルの配線、UI、マテリアル、アニメーション、パーティクル、カメラ、環境の設定を行うことができます。 ## クイックスタート ### 要件 - Godot AI v4用のGodot 4.7以上（4.x系内） - uv（Pythonサーバー用のuvxを提供） - MCPクライアント ### インストール 1. **新規プロジェクト:** GitHub Releasesから公開バージョンをダウンロードし、`your-project/addons/godot_ai/`に`plugin.cfg`を含むアドオンをインストールします。 2. **既存のインストール:** Godot AIドックの更新ボタンを使用します。最終署名済みv3リリースは、v4へのワンクリック移行をサポートしています。 ### プラグインの有効化 Godotで: **プロジェクト → プロジェクト設定 → プラグイン → Godot AI**。 プラグインはMCPサーバーを起動し、Godot AIドックに接続ステータスを表示します。 ### MCPクライアントの接続 ドックで、クライアントの横にある**設定**を押すか、検出されたすべてのクライアントに対して**すべて設定**を押します。サポートされているクライアントには、Claude Code、Claude Desktop、Codex、Antigravity、Hermes Agent、DeepSeek Harness、Cursor、VS Codeが含まれます。 ### 試してみる プロンプトの例: - "現在のシーン階層を表示してください。" - "/Mainの下にMainCameraという名前のCamera3Dを作成してください。" - "プロジェクト内のui/にあるPackedSceneファイルを検索してください。" - "シーンテストスイートを実行してください。" - "プレイヤー、配置・破壊可能なブロック、セーブスロットを備えたボクセルブロックワールドゲームを構築してください。" ## 仕組み ```text MCPクライアント → godot-ai attach (stdio) → Pythonサーバー (認証付きHTTP、ポート8000) → Godotエディタプラグイン (認証付きWebSocket、ポート9500) ``` 両方のローカルホップは独立したローテーション認証情報を使用し、認証なしのアクセスにフォールバックすることはありません。エディタのWebSocketはループバックのみに制限されています。コンテナ内や他のマシン上のエージェントの場合は、エディタマシン上でSSH経由でブリッジを実行します。 ## テレメトリとプライバシー 使用テレメトリは、インストールUUID、イベント、結果、期間、プラットフォーム、バージョンを記録しますが、コード、シーン内容、プロジェクト/ファイル名は記録しません。プロジェクトディレクトリのスラッグは送信前にハッシュ化されます。 `GODOT_AI_DISABLE_TELEMETRY=true`または`DISABLE_TELEMETRY=true`でオプトアウトできます。 ## ドキュメントとサポート ### Bazzite / Fedora Atomic Desktopの問題 Bazziteや他のFedora Atomicデスクトップでは、`/home`は通常`/var/home`へのシンボリックリンクです。Godot AI 4.0.2以前は、リンクを通過するすべてのケーパビリティディレクトリパスを拒否します。次のリリースでは、リンクがルート所有で、他のアカウントが書き込めないルート所有ディレクトリにある場合にリンクを追跡します。 4.0.2以前の場合は、`GODOT_AI_CAPABILITY_DIR`を正規パスに設定し、そのターミナルからGodotとMCPクライアントの両方を起動します。 ### リファレンスとサポート - ツール、操作、リソース - ゲームのテストの作成と実行 - クライアント設定の詳細 - v3からのアップグレードと中断された移行の回復 - 変更ログ - 貢献と開発環境のセットアップ - 質問やショーケース用のDiscord、バグ報告用のGitHub Issues **ライセンス:** MIT