Godot4 Runtime MCP

🚀 示例 Godot プロジェクト

このディレクトリには、MCP プラグインの使用方法を示すためのシンプルな Godot 4 のサンプルプロジェクトが含まれています。

📦 プロジェクト構造

ExampleProject/
├── project.godot          # Godot プロジェクト設定
├── addons/
│   └── mcp_client/        # MCP プラグイン（上位ディレクトリからコピー）
├── scenes/
│   ├── main.tscn          # メインシーン
│   └── player.tscn        # プレイヤーシーン
└── scripts/
    └── Player.cs          # プレイヤースクリプト

🚀 クイックスタート

1. Godot プロジェクトの作成

Godot エディタで以下の手順を行います：

1. 新しいプロジェクトを作成します。
2. スクリプト言語として C# を選択します。
3. プロジェクトを保存します。

2. MCP プラグインのインストール

# プロジェクトのルートディレクトリから
cp -r GodotPlugin ExampleProject/addons/mcp_client

または、手動で GodotPlugin フォルダを ExampleProject/addons/mcp_client にコピーしてください。

3. プラグインの有効化

1. Godot エディタでプロジェクトを開きます。
2. 「プロジェクト」 -> 「プロジェクト設定」 -> 「プラグイン」と選択します。
3. 「MCP Client」を有効にします。

4. テストシーンの作成

メインシーン (main.tscn)

以下のノード構造を作成します：

Main (Node2D)
├── Player (CharacterBody2D)
│   └── Sprite2D
└── Camera2D

プレイヤースクリプト (Player.cs)

using Godot;

public partial class Player : CharacterBody2D
{
    [Export]
    public float Speed { get; set; } = 200.0f;
    
    [Export]
    public int Health { get; set; } = 100;

    public override void _PhysicsProcess(double delta)
    {
        Vector2 velocity = Velocity;
        Vector2 direction = Input.GetVector("ui_left", "ui_right", "ui_up", "ui_down");
        
        if (direction != Vector2.Zero)
        {
            velocity = direction * Speed;
        }
        else
        {
            velocity = Vector2.Zero;
        }

        Velocity = velocity;
        MoveAndSlide();
    }
    
    public void TakeDamage(int damage)
    {
        Health -= damage;
        GD.Print($"Player took {damage} damage. Health: {Health}");
        
        if (Health <= 0)
        {
            Die();
        }
    }
    
    public void Heal(int amount)
    {
        Health += amount;
        GD.Print($"Player healed {amount}. Health: {Health}");
    }
    
    private void Die()
    {
        GD.Print("Player died!");
        // ここに死亡ロジックを追加できます
    }
}

5. 実行とテスト

1. MCP サーバーを起動します。

./start-server.sh

2. Godot でゲームを実行します (F5)。

3. Claude で MCP ツールをテストします。

💻 使用例

基礎操作

1. シーンツリーの表示

現在のシーンツリー構造を取得する

2. プレイヤー情報の表示

ノード /root/Main/Player の詳細情報を取得する

3. プレイヤー属性の表示

/root/Main/Player の Speed と Health 属性を取得する

変更操作

4. 速度の変更

プレイヤーの Speed 属性を 500 に設定する

5. 位置の変更

プレイヤーの位置を (400, 300) に設定する

6. メソッドの呼び出し

/root/Main/Player の TakeDamage メソッドを呼び出し、引数を [20] とする

高度な操作

7. 新しいノードの作成

/root/Main の下に "Enemy" という名前の CharacterBody2D ノードを作成する

8. パフォーマンス監視

現在のパフォーマンス統計情報を取得する

9. スクリーンショット

現在のゲーム画面をキャプチャして保存する

📊 期待結果

シーンツリー出力

{
  "path": "/root",
  "name": "root",
  "type": "Window",
  "children": [
    {
      "path": "/root/Main",
      "name": "Main",
      "type": "Node2D",
      "children": [
        {
          "path": "/root/Main/Player",
          "name": "Player",
          "type": "CharacterBody2D",
          "children": [...]
        }
      ]
    }
  ]
}

ノード情報出力

{
  "path": "/root/Main/Player",
  "name": "Player",
  "type": "CharacterBody2D",
  "properties": {
    "position": {"x": 0, "y": 0},
    "Speed": 200,
    "Health": 100
  },
  "methods": ["TakeDamage", "Heal", "_PhysicsProcess", ...],
  "signals": [...]
}

🛠️ トラブルシューティング

プラグインが読み込まれない場合

• プラグインファイルが正しい位置にあることを確認してください。
• plugin.cfg の形式が正しいことを確認してください。
• Godot エディタを再起動してください。

MCP サーバーに接続できない場合

• MCP サーバーが実行中であることを確認してください。
• ポート 7777 が使用されていないことを確認してください。
• Godot コンソールのエラーメッセージを確認してください。

ノードパスが間違っている場合

• get_scene_tree を使用して正しいノードパスを確認してください。
• ノードパスは大文字と小文字が区別されます。
• 絶対パス（/root で始まる）を使用することを確認してください。

🎓 拡張練習

1. 複数の敵を作成する

   • create_node を使用して 5 - 10 個の敵を作成します。
   • 各敵にランダムな位置を設定します。

2. パフォーマンス最適化

   • FPS を監視します。
   • get_scene_tree を使用してノード数を確認します。
   • 不要なノードを削除してみます。

3. ゲームバランス調整

   • プレイヤーの速度を動的に調整します。
   • 異なる Health 値をテストします。
   • ゲームの難易度をリアルタイムで調整します。

4. デバッグワークフロー

   • ゲーム実行中に変数を変更します。
   • 境界条件をテストします。
   • ゲームロジックを検証します。

🚀 次のステップ

• より複雑なシーンを作成する
• より多くのゲームロジックを追加する
• MCP ツールを使用して AI 支援開発を行う
• 自動化テストの可能性を探索する