Godot MCP

Godot MCP

                           (((((((             (((((((
                        (((((((((((           (((((((((((
                        (((((((((((((       (((((((((((((
                        (((((((((((((((((((((((((((((((((
                        (((((((((((((((((((((((((((((((((
         (((((      (((((((((((((((((((((((((((((((((((((((((      (((((
       (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
     ((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
    ((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
      (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
        (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
         (((((((((((@@@@@@@(((((((((((((((((((((((((((@@@@@@@(((((((((((
         (((((((((@@@@,,,,,@@@(((((((((((((((((((((@@@,,,,,@@@@(((((((((
         ((((((((@@@,,,,,,,,,@@(((((((@@@@@(((((((@@,,,,,,,,,@@@((((((((
         ((((((((@@@,,,,,,,,,@@(((((((@@@@@(((((((@@,,,,,,,,,@@@((((((((
         (((((((((@@@,,,,,,,@@((((((((@@@@@((((((((@@,,,,,,,@@@(((((((((
         ((((((((((((@@@@@@(((((((((((@@@@@(((((((((((@@@@@@((((((((((((
         (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
         (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
         @@@@@@@@@@@@@((((((((((((@@@@@@@@@@@@@((((((((((((@@@@@@@@@@@@@
         ((((((((( @@@(((((((((((@@(((((((((((@@(((((((((((@@@ (((((((((
         (((((((((( @@((((((((((@@@(((((((((((@@@((((((((((@@ ((((((((((
          (((((((((((@@@@@@@@@@@@@@(((((((((((@@@@@@@@@@@@@@(((((((((((
           (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
              (((((((((((((((((((((((((((((((((((((((((((((((((((((
                 (((((((((((((((((((((((((((((((((((((((((((((((
                        (((((((((((((((((((((((((((((((((


                          /$$      /$$  /$$$$$$  /$$$$$$$
                         | $$$    /$$$ /$$__  $$| $$__  $$
                         | $$$$  /$$$$| $$  \__/| $$  \ $$
                         | $$ $$/$$ $$| $$      | $$$$$$$/
                         | $$  $$$| $$| $$      | $$____/
                         | $$\  $ | $$| $$    $$| $$
                         | $$ \/  | $$|  $$$$$$/| $$
                         |__/     |__/ \______/ |__/

Godot ゲームエンジンと連携するための Model Context Protocol（MCP）サーバーです。

はじめに

Godot MCP を使うと、AI エージェントが Godot エディターを起動したり、プロジェクトを実行したり、デバッグ出力を取得したり、プロジェクトの実行を制御したりできます。この直接的なフィードバックループにより、エージェントは実際の Godot プロジェクトで何が機能し、何が機能しないかを把握できるため、コード生成やデバッグ支援の質が向上します。

機能

• Godot エディターの起動：特定のプロジェクト用に Godot エディターを開きます
• Godot プロジェクトの実行：Godot プロジェクトをデバッグモードで実行します
• デバッグ出力の取得：コンソール出力とエラーメッセージを取得します
• 実行の制御：Godot プロジェクトをプログラムから開始および停止します
• Godot バージョンの取得：インストールされている Godot のバージョンを取得します
• Godot プロジェクトの一覧表示：指定したディレクトリ内の Godot プロジェクトを検索します
• プロジェクト分析：プロジェクト構造に関する詳細情報を取得します
• シーン管理：
  • 指定したルートノードタイプで新しいシーンを作成します
  • カスタマイズ可能なプロパティを指定して既存のシーンにノードを追加します
  • Sprite2D ノードにスプライトとテクスチャを読み込みます
  • 3D シーンを GridMap 用の MeshLibrary リソースとしてエクスポートします
  • バリアントを作成するオプションを指定してシーンを保存します
• UID 管理（Godot 4.4 以降）：
  • 特定のファイルの UID を取得します
  • リソースを再保存して UID 参照を更新します

要件

• システムに Godot Engine がインストールされていること
• Node.js（>=18.0.0）および npm
• MCP をサポートする AI エージェント

クイックスタート

Claude Code

claude mcp add godot -- npx @coding-solo/godot-mcp

これで完了です。Claude Code を再起動すると、Godot MCP ツールを利用できます。

環境変数を使用する場合：

claude mcp add godot -e GODOT_PATH=/path/to/godot -e DEBUG=true -- npx @coding-solo/godot-mcp

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["@coding-solo/godot-mcp"],
      "env": {
        "DEBUG": "true"
      },
      "disabled": false,
      "autoApprove": [
        "launch_editor",
        "run_project",
        "get_debug_output",
        "stop_project",
        "get_godot_version",
        "list_projects",
        "get_project_info",
        "create_scene",
        "add_node",
        "load_sprite",
        "export_mesh_library",
        "save_scene",
        "get_uid",
        "update_project_uids"
      ]
    }
  }
}

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["@coding-solo/godot-mcp"],
      "env": {
        "DEBUG": "true"
      }
    }
  }
}

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["@coding-solo/godot-mcp"],
      "env": {
        "GODOT_PATH": "/path/to/godot",
        "DEBUG": "true"
      }
    }
  }
}

git clone https://github.com/Coding-Solo/godot-mcp.git
cd godot-mcp
npm install
npm run build

アーキテクチャ

Godot MCP サーバーは、複雑な操作にバンドルされた GDScript を使用します。

1. 直接コマンド：エディターの起動やプロジェクト情報の取得などのシンプルな操作では、Godot に組み込まれた CLI コマンドを直接使用します。
2. バンドルされた操作スクリプト：シーンの作成やノードの追加などの複雑な操作では、すべての操作を処理する単一の包括的な GDScript ファイル（godot_operations.gd）を使用します。

バンドルされたスクリプトは、操作の種類とパラメーターを JSON として受け取ります。これにより、操作ごとに一時ファイルを生成せずに、柔軟かつ動的に操作を実行できます。

トラブルシューティング

• Godot が見つからない：環境変数 GODOT_PATH に Godot 実行ファイルへのパスを設定してください
• 接続の問題：サーバーが実行中であることを確認し、AI アシスタントを再起動してください
• 無効なプロジェクトパス：project.godot ファイルを含むディレクトリを指していることを確認してください
• ビルドの問題：npm install を実行して、すべての依存関係がインストールされていることを確認してください

ライセンス

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