Godot Script Integration

🚀 Godot MCP（モデルコンテキストプロトコル）

このプラグインは、Model Context Protocol (MCP) を使用して、Godot エンジンと AI アシスタントを完全に統合します。AI アシスタントがあなたの Godot プロジェクトとやり取りできるようにし、強力なコード支援、シーン操作、およびプロジェクト管理機能を提供します。

✨ 主な機能

• Godot プロジェクトの完全アクセス：AI アシスタントがスクリプト、シーン、ノード、およびプロジェクトリソースにアクセスし、変更することができます。
• 双方向通信：プロジェクトデータを AI に送信し、エディタ内で直接その提案された変更を適用できます。
• コマンドの種類：
  • ノードコマンド：シーン内のノードを作成、変更、管理します。
  • スクリプトコマンド：GDScript ファイルを編集、分析、作成します。
  • シーンコマンド：シーンとその構造を操作します。
  • プロジェクトコマンド：プロジェクト設定とリソースにアクセスします。
  • エディタコマンド：さまざまなエディタ機能を制御します。

🚀 クイックスタート

1. リポジトリをクローンする

git clone https://github.com/ee0pdt/godot-mcp.git
cd godot-mcp

2. MCP サーバーを設定する

cd server
npm install
npm run build
# プロジェクトのルートディレクトリに戻る
cd ..

3. Claude デスクトップ版を設定する

1. Claude デスクトップ版の設定ファイルを編集または作成します。

   # macOS の場合
   nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
   

2. 以下の設定を追加します（または、含まれている claude_desktop_config.json をサンプルとして参照してください）。

   {
     "mcpServers": {
       "godot-mcp": {
         "command": "node",
         "args": [
           "PATH_TO_YOUR_PROJECT/server/dist/index.js"
         ],
         "env": {
           "MCP_TRANSPORT": "stdio"
         }
       }
     }
   }
   

   ⚠️ 重要提示

   PATH_TO_YOUR_PROJECT を、このリポジトリを保存した実際のパスに置き換えてください。

3. Claude デスクトップ版を再起動します。

4. Godot でサンプルプロジェクトを開く

1. Godot エンジンを開きます。
2. "インポート" を選択し、クローンしたリポジトリに移動します。
3. project.godot ファイルを開きます。
4. このサンプルプロジェクトでは、MCP プラグインが有効になっています。

💻 使用例

Claude デスクトップ版で MCP を使用する

• プラグインを起動する：Godot で、Project > Project Settings > Plugins を選択し、"Godot MCP" を有効にします。
• AI アシスタントに接続する：Claude デスクトップ版が実行中で、MCP サーバーが正しく設定されていることを確認します。

新しいシーンを作成する

1. Godot を開き、プロジェクトを読み込みます。
2. エディタで、シーンツリーを右クリックし、"Create New Scene" を選択します。
3. シーン設定を構成し、保存します。

プロジェクトをエクスポートする

# ターミナルで以下のコマンドを実行して HTML5 としてエクスポートする
export_project ../export/html5/

📚 ドキュメント

コマンドの参照

シーンコマンド

• scene/create：新しいシーンを作成します。
• scene/open：既存のシーンを開きます。
• scene/save：現在のシーンを保存します。

ノードコマンド

• node/add：シーンにノードを追加します。
• node/remove：指定されたノードを削除します。
• node/edit：ノードの属性を変更します。

トラブルシューティング

プラグインが機能しない場合

• 構成を変更した後は、Godot プロジェクトを再読み込みします。
• Godot コンソールのエラーメッセージを確認します。
• Claude デスクトップ版の設定内のパスが正しいことを確認します。

カスタムプロジェクトの統合

1. addons/godot_mcp フォルダを、あなたの Godot プロジェクトの addons ディレクトリにコピーします。
2. プロジェクトを起動し、Project > Project Settings > Plugins を選択し、"Godot MCP" を有効にします。

貢献

ご協力を歓迎します！自由に Pull Request を送信してください。

詳細なドキュメント

詳細情報については、docs フォルダ内のドキュメントを参照してください。

• はじめに
• インストールガイド
• コマンドリファレンス
• アーキテクチャ

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細は LICENSE ファイルを参照してください。