Home
Login
Coding-Solo/godot-mcpPlease refer to the latest official releases for information GitHub Homepage

Godotゲームエンジンと連携するためのMCPサーバー。エディタの起動、プロジェクトの実行、デバッグ出力のキャプチャなどのツールを提供します。

MITJavaScript 0.5kCoding-Solo Last Updated: 2025-03-23

📚 Godot MCP プロジェクト紹介

一、プロジェクト概要

Godot MCP（Model Context Protocol サーバー）は、Coding‑Solo によって公開された、AI アシスタントと Godot エンジンを橋渡しするツールです。MCP プロトコルを通じて、Godot エディターの起動、プロジェクトの実行、デバッグ情報の取得、そしてプロジェクト構造とシーンの深い制御が可能になります。

このメカニズムは、AI アシスタント（Claude、Cline、Cursor など）に実際のフィードバックループを提供し、プロジェクトの操作、問題のデバッグ、高品質な GDScript コードの生成を可能にします。

二、コア機能と特性

  1. エディターの起動とプロジェクトの実行 コマンドライン方式で以下をサポートします。

    • 指定されたパスの Godot エディターを起動
    • デバッグモードでプロジェクトを実行
    • コンソール出力またはエラー情報をキャプチャして返す

  2. プロジェクト構造の取得と分析

    • プロジェクトのバージョン、ディレクトリ構造、リソースリストを取得
    • ノードツリー、属性、リソースパスなど、シーン構造の詳細情報を取得

  3. シーンとノードの管理

    • 新しいシーンを作成（ルートノードタイプを指定）
    • 既存のシーンにノードを追加し、属性を設定
    • Sprite2D テクスチャのロード、GridMap 用の MeshLibrary のエクスポート
    • シーンを保存し、シーンバリアントの生成をサポート

  4. デバッグとバージョン管理

    • 実行中のプロジェクトを停止
    • Godot エンジンのバージョンを取得して表示
    • （Godot 4.4+ に適用）ファイルの UID を取得し、リソース参照を更新

  5. 多様な AI 補助ツールとの互換性

    • Cline と Cursor をサポート：MCP 設定ファイル、コマンドライン統合で AI アシスタントツールを統合

三、アーキテクチャと実装のハイライト

  • 単一の GDScript "操作スクリプト" ノードの作成、シーンのエクスポートなど、すべての複雑なコマンドは、godot_operations.gd によって管理されます。一時的なスクリプトを個別に生成することを避け、簡潔さと効率を保証し、ディスク I/O とエラーの可能性を減らします。

  • CLI と Script の組み合わせメカニズム 簡単なコマンドは Godot CLI を通じて直接実行し、複雑な操作は GDScript スクリプトを通じて実行します。どちらも MCP 標準で JSON 指令を送信し、構造が統一され、拡張が容易です。

  • 標準化された応答構造 すべての操作は、ステータス、結果の内容、標準出力/エラーという統一された形式で返されます。これにより、AI が分析、学習、変更提案の自動生成を容易に行うことができます。

四、使用フロー

  1. インストールとビルド

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

  2. AI ツールの設定

    • Cline：cline_mcp_settings.json に対応するサーバー設定を追加
    • Cursor：Settings → Features → MCP を通じて node 指令を追加

  3. 実行とインタラクション

    • AI 指令の例：

      • launch_editor：エディターを起動
      • run_project：プロジェクトを実行して出力を取得
      • create_scene / add_node：シーン/ノードを作成
      • get_debug_output / stop_project：デバッグ制御系の指令
      • get_uid / update_project_uids：UID 管理

五、プロジェクトのハイライトまとめ

利点 説明
🌟 高い自動化 AI アシスタントがエディター/プロジェクトを直接操作し、手動介入は不要
🚫 一時ファイルなし GDScript の単一エントリポイントを使用し、軽量かつ効率的
♻️ バージョン & UID をサポート Godot 4.4+ の機能をサポートし、リソース UID を管理可能
🛠️ 拡張性と統合が容易 MCP 標準により、新機能の追加が容易で、複数の AI ツールと互換性あり

六、まとめ 🌈

Godot MCP は、強力で実用的なツールであり、AI アシスタントと Godot エンジンを繋ぐ架け橋となります。AI は以下を直接実行できます。

  • エディターの起動、プロジェクトの実行、データ収集
  • プロジェクト構造、スクリプト、シーン、リソースへのアクセス
  • シーン、ノード、スクリプトの動的な変更
  • デバッグ、GDScript コードの提案生成

統一されたプロトコルと GDScript 操作スクリプトにより、明確で標準化された、拡張可能な自動化インターフェースを提供し、ゲーム開発者にとって、効率とインテリジェントな開発プロセスを向上させるための強力なツールとなります。