Godot MCP Server

Godot MCP Server とは？

Godot MCP Server は、コミュニティが開発した godot mcp 連携ツールで、AI アシスタントが Model Context Protocol を通じて Godot エディターの起動、プロジェクトの実行、デバッグ出力の取得、シーンの編集を行えるようにします。エージェントに実際の Godot プロジェクトとの直接的なフィードバックループを提供します。

このプロジェクトは GitHub 上で Coding-Solo が MIT ライセンスで開発しており、npm では @coding-solo/godot-mcp として公開されています。Godot Engine の公式製品ではありません。stdio でローカルに動作し、インストール済みの Godot 実行ファイルを呼び出すため、AI クライアントがモデルに送信する内容以外のデータがマシンの外に出ることはありません。

Godot MCP Server の使い方

README に記載されている前提条件：

• システムに Godot Engine がインストールされていること
• Node.js 18.0.0 以降と npm
• MCP に対応した AI クライアント

API キーは不要です。オプションの環境変数が 2 つあります。

変数	用途
GODOT_PATH	Godot 実行ファイルのパス（自動検出より優先）
DEBUG	"true" にするとサーバー側の詳細なデバッグログを有効化

Claude Code

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

環境変数を指定する場合：

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

Claude Code を再起動すると Godot のツールが使えるようになります。

Cursor

UI では Cursor Settings > Features > MCP を開き、+ Add New MCP Server をクリックして、名前 godot、タイプ command、コマンド npx @coding-solo/godot-mcp を入力します。ツール一覧を読み込むには、サーバーカード右上の更新ボタンを押す必要がある場合があります。プロジェクト単位で設定するには .cursor/mcp.json を作成します。

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

Claude Desktop、Cline、その他のクライアント

Claude Desktop や Cline など、MCP 対応クライアントであれば README の汎用設定を使えます。

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

Cline の場合、README ではこの設定を cline_mcp_settings.json に記述し、確認プロンプトを省略したいときのための autoApprove ツール名リストも示しています。

ソースからビルドする

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

その後、npx の代わりに build/index.js を MCP クライアントに指定します。

Godot MCP Server の主な機能

• 指定したプロジェクトで Godot エディターを起動
• プロジェクトをデバッグモードで実行し、コンソール出力とエラーを取得
• 実行中のプロジェクトをプログラムから開始・停止
• インストール済みの Godot バージョンを取得し、ディレクトリ内の Godot プロジェクトを検索
• プロジェクトの構造とメタデータを取得
• シーンの作成、プロパティ付きノードの追加、Sprite2D ノードへのスプライト読み込み、バリアント作成を含むシーンの保存
• 3D シーンを GridMap 用の MeshLibrary リソースとしてエクスポート
• Godot 4.4 以降のプロジェクトで UID を管理

内部的には、単純な操作は Godot 組み込みのコマンドラインインターフェースを使い、シーン作成やノード追加などの複雑な操作は、操作の種類とパラメーターを JSON で受け取る単一の同梱 GDScript ファイル godot_operations.gd で処理します。

Godot MCP Server のツール

サーバーは 4 つのグループに分かれた 14 個のツールを提供します。

• エディターと実行の制御： launch_editor はプロジェクトのエディターを開き、run_project はプロジェクトを実行して出力を取得し、get_debug_output は現在のログとエラーを返し、stop_project は実行を終了します。これにより、エージェントはコードを変更し、ゲームを実行し、何が問題だったかを読み取れます。
• プロジェクトの把握： get_godot_version、list_projects、get_project_info で、インストール済みのエンジンバージョンとプロジェクトの内容をエージェントに伝えます。
• シーン編集： create_scene、add_node、load_sprite、save_scene、export_mesh_library で、手動でエディターを開かずに .tscn シーンを作成・変更できます。
• UID 管理（Godot 4.4 以降）： get_uid はファイルの UID を返し、update_project_uids はリソースを再保存して UID 参照を更新します。

Godot MCP Server のユースケース

• エージェントとのデバッグループ： 「プロジェクトを実行してデバッグ出力を読み、player.gd の null 参照エラーを修正して。」
• シーンの雛形作成： 「CharacterBody2D をルートにした新しいシーンを作り、Sprite2D を追加して res://art/hero.png を読み込んで。」
• プロジェクトの調査： 「~/games にある Godot プロジェクトを一覧にして、プラットフォーマーのプロジェクト構成を教えて。」
• 3D レベル用ツール： 「tiles シーンを MeshLibrary としてエクスポートして、GridMap で使えるようにして。」
• Godot 4.4 へのアップグレード： 「ファイルを移動したので、プロジェクト全体の UID 参照を更新して。」
• 簡易スモークテスト： 編集のたびに Claude Code や Cursor からゲームを実行し、コンソールのエラーを確認します。

Godot MCP Server と代替ツールの比較

Godot MCP Server は、ゲームエンジン向けのコミュニティ製 MCP サーバーの 1 つです。他のエンジンを使う場合、Unity MCP は AI アシスタントを Unity エディターに、Blender MCP は Blender の 3D シーンに接続します。GitHub には異なるツールセットを持つ独立した Godot MCP プロジェクトも存在するため、選ぶ前に各 README を比較してください。Coding-Solo 版は npx による簡単なインストールと、プロジェクトの実行とデバッグ出力の取得に重点を置いている点が特徴です。

Godot MCP Server のトラブルシューティング

• Godot が見つからない： GODOT_PATH に Godot 実行ファイルのフルパスを設定します。
• プロジェクトパスが無効： パスは project.godot ファイルを含むディレクトリを指している必要があります。
• 接続の問題： サーバーが動作していることを確認し、AI アシスタントを再起動します。
• ソースからのビルドエラー： npm install を実行して、すべての依存関係をインストールします。
• Cursor でツールが表示されない： Settings > MCP にサーバーが表示され、有効になっていることを確認します。README によると、MCP ツールは Cursor の Agent チャットモードでのみ実行できます。