Back to Blog
·Summer Team

Godot MCPとは何か?2026年版わかりやすい解説

Godot MCPとは何か、Model Context ProtocolがCursorやClaudeのようなAIクライアントをGodotプロジェクトにどうつなぐのか、できることとできないこと、そして導入方法を解説します。

CursorやClaudeまわりで「Godot MCP」という言葉を目にしたものの、プラグインなのかサービスなのかバズワードなのかよくわからなかった方のために、わかりやすく解説します。Godot MCPはModel Context Protocolを基盤としたGodot統合であり、各パーツのつながりを理解すれば、乱立する競合サーバーの全体像が見えてきます。

{/* IMAGE: Diagram of an AI client (Cursor/Claude) on the left, an MCP server in the middle exposing a list of tools, and a Godot project on the right. 1200x630, illustration. */}

MCPとは何か、1段落で

Model Context Protocolは、AIクライアントを外部ツールに接続するためのオープン標準です。AIアプリがそれぞれ独自のプラグイン形式を作る代わりに、MCPはクライアントがツールを発見し、呼び出し、結果を受け取るための共通の方法を定義します。Cursor、Claude Desktop、Claude Code、Windsurf、ClineといったクライアントはMCPを話し、サーバーはMCPを通じてツールを公開します。標準規格であるため、1つのサーバーをそれらすべてのクライアントで動作させることができ、クライアントごとの独自実装は不要です。それだけです。MCPは配線です。

「Godot MCP」が意味すること

Godot MCPは、Godotプロジェクトを操作するツールを持つMCPサーバーを誰かが構築したときに生まれるものです。サーバーはAIクライアントと並行して動作する小さなプログラムで、Godotで行う操作に合わせたツールを提供します。シーンツリーの読み取り、.tscnファイルのノード階層とシグナル接続の解析、.gdスクリプトの参照と書き換え、プロジェクト設定の読み取りといったことができます。

恩恵はAIがプロジェクトの中身を見えるようになることです。サーバーなしでは「CharacterBody3DにCollisionShape3DとAnimationPlayerがあって、スクリプトはこんな感じ」とテキストで貼り付けて説明しなければなりません。Godot MCPサーバーが接続されていれば、AIは自分でその構造を読み取り、実際のファイルを編集します。プロジェクトを説明する立場から、アシスタントに直接調べてもらう立場に変わります。

3つの単語、3つの役割:

  • MCPはオープンプロトコル、クライアントとサーバー間の共通言語。
  • サーバーはそのプロトコルをGodot固有のツールに変換するアダプター。
  • クライアントはそれらのツールをユーザーの代わりに呼び出すAIアプリ(Cursor、Claudeなど)。

Godot MCPサーバーの2つの層

ここは多くの解説が省略する部分ですが、実際にサーバーを選ぶ際に最も重要なポイントです。Godot MCPサーバーには2つの層があり、それぞれ問題の異なる半面を解決します。

ファイルレベルのサーバーはプロジェクト内のファイルを読み書きします。.tscnシーンファイルを解析してノード構造を把握し、.gdスクリプトを参照・書き換え、プロジェクト設定を読み取ります。Godot MCPサーバーの大多数がこれに該当し、コードの作成やリファクタリングには十分な機能です。GDAI MCPとCoding-SoloのgodotMCPが代表的な例です。各サーバーの詳細はGodot MCPサーバーガイドをご覧ください。

エンジンレベルのサーバーは動作中のエンジンインスタンスに橋渡しします。ファイルレベルのサーバーができることに加えて、稼働中のシーンツリーへのノード追加、シーンの実行、ゲーム実行中のデバッガーと診断情報の読み取り、アセットの生成が可能です。この層はエンジン本体の協力が必要なため、単なるファイルアクセスより難易度が高く、実装例は少数です。

「最高のGodot MCPサーバー」を巡る議論の多くは、ファイルレベルのサーバー同士を比較しているだけで、エンジンレベルの層の存在に気づいていないことがほとんどです。どちらも正当な選択肢です。一方はAIがプロジェクトを編集するための助けになり、もう一方はAIがプロジェクトを実行するための助けになります。

Godot MCPにできること

ファイルレベルのサーバーが接続されていれば、AIクライアントは確実に以下ができます:

  • プロジェクトの構造を読み取り、シーン一覧を表示する。
  • .tscnファイルをノードツリーに解析し、シグナル接続を読み取る。
  • .gdスクリプトを参照し、文脈を理解した上で書き換える。
  • プロジェクト設定を読み取り、実際の設定に基づいた編集を行う。

コピー&ペーストに比べれば大きな進歩で、コード中心の作業ではその大部分の価値を発揮します。

エンジンレベルのサーバーでは、さらに以下が可能になります:

  • ファイルだけでなく、稼働中のシーンツリー上でノードを作成・変更する。
  • 再生ボタンを押してシーンを実行する。
  • ゲーム実行中にデバッガー出力と診断情報を読み取る。
  • プロジェクトに直接インポートされる3Dモデル、画像、音声を生成する。

具体的なタスクでその違いがはっきりします。「HUDカウンター付きのコイン収集機能」を依頼した場合、ファイルレベルのサーバーは関連ファイルを書き換えて返します。エンジンレベルのサーバーはArea3Dを作成し、スクリプトを書いてアタッチし、稼働中のレベルにコインを配置し、ゲームを実行して、カウンターが実際に増加したかどうかを確認します。前者はコードを渡し、後者は動作を確認します。Cursor + Godot対Summer Engineの比較記事では、この例を両方のスタックで詳しく検証しています。

Godot MCPにできないこと

AIが作ったGodotゲームが静かに壊れていくのはまさにここなので、限界について率直に話しましょう。

ファイルレベルのGodot MCPサーバーは再生ボタンを押してゲームを見ることができません。スクリプトの読み書きや.tscnファイルの解析はできますが、レンダリング出力の確認、デバッガーのステップ実行、ランタイム変数値の検査、ジャンプの弧や物理インタラクションの感触が適切かどうかの判断はできません。そのため、AIが生成したGDScriptは一見正しく見えて検査も通るにもかかわらず、ランタイムで例外を投げることがあります。たとえばGodot 3の呼び出しを誤って使った場合などです。ファイルレベルのサーバーでは、そのランタイムエラーを見つけるのはあなたの仕事です。

この限界は特定のサーバーの欠陥ではありません。動作中のエンジンなしにテキストを編集することの構造的な制約です。これを解消するにはエンジンをループに組み込む必要があり、それがまさにエンジンレベルの層が提供するものです。エンジン内蔵エージェントのできることとできないことについてはGodotのAIエージェントガイドを、標準GodotにこれらがAI機能として含まれるかどうかについてはGodotはAIを持っているかをご覧ください。

Godot MCPサーバーの導入方法

具体的な手順はサーバーによって異なりますが、形は同じです。サーバーをインストールするか指定し、クライアントの設定に小さなエントリを追加します。

ファイルレベルのサーバー(セルフホスト)。 ほとんどはNodeまたはPython製です。サーバーをインストールし、クライアントの設定ファイルにそのサーバーを指すエントリを追加します。Cursorの場合は.cursor/mcp.json、Claude Desktopの場合はアプリのMCP設定画面です。stdioサーバーのエントリはおおよそ次のようになります:

{
  "mcpServers": {
    "godot": {
      "command": "node",
      "args": ["/path/to/godot-mcp/index.js"],
      "env": {
        "GODOT_PROJECT_PATH": "/path/to/your/godot/project"
      }
    }
  }
}

クライアントを再起動して「このプロジェクトにはどんなシーンがありますか?」と聞いてみて、接続を確認してください。

エンジンレベルのサーバー(ホスト型)。 Summer Engineのサーバーはホスト型なので、何もインストールせずに1つのURLをクライアントに指定するだけです。Cursorの.cursor/mcp.jsonの場合:

{
  "mcpServers": {
    "summer-engine": {
      "url": "https://www.summerengine.com/mcp",
      "transport": "http"
    }
  }
}

クライアントを再起動し、Summer Engineでプロジェクトを開いてブリッジに接続するエンジンを用意すれば、エンジンレベルのツールがネイティブの呼び出しとして利用可能になります。同じ手順がClaude Code、Codex CLI、Gemini CLI、Windsurf、Clineでも使えます。各クライアントの詳細な手順はsummerengine.com/mcpをご覧ください。

Godot MCPは無料ですか?

プロトコルは無料でオープンです。コミュニティ製のファイルレベルサーバー(GDAI MCP、Coding-Solo、bradypp、satelliteoflove)も無料のオープンソースです。セルフホスト型なので、継続的なコストはOpenAIやAnthropicを通じてクライアントが課金するAIモデルの計算コストのみで、サーバー自体は何も上乗せしません。Summer EngineのホストMCPサーバーは接続も利用開始も無料で、上限を引き上げたり3D生成などの重い処理を解放したりする有料プランは料金ページで確認できます。どれも最初から課金されるものはありません。選ぶのはメーターの置き場所です。セルフホストのファイルサーバーなら自分のモデルキー、ホスト型エンジンレベルサーバーなら同梱の生成機能と上限です。

Summer Engineの位置づけ

私たちもこうしたツールの1つを作っているので、簡単に正直にお伝えします。Summer EngineはGodot 4と互換性のあるAIネイティブなゲームエンジンで、.godotプロジェクトを開き、あなたが所有できる本物のシーンとGDScriptを生成します。そこから2つのことが生じます。

1つ目は、AIエージェントがエンジンに組み込まれているため、外部のGodot MCPサーバーを使わなくてもSummer Engineを利用できるということです。チャットを通じて稼働中のシーンツリーを直接操作します。このエンジン内蔵アプローチが橋渡し方式とどう違うかはGodot AIページで説明しています。

2つ目は、Summerが逆方向のためにsummerengine.com/mcpでホスト型MCPサーバーも公開しているということです。CursorやClaude Codeなど使い慣れたIDEを維持しながら、エンジンレベルの操作(シーンの実行、ライブランタイムエラーの読み取り、アセット生成)も活用したい場合は、そのクライアントをSummerのサーバーに向けてエンジンをリモートで操作できます。つまり、既存のクライアントに実際に動くエンジンを組み合わせたいときはMCPサーバーを使い、Summer自身のチャット内で作業するときはスキップする、ということです。

概念を学んでいるのではなく特定のサーバーを選ぶ段階にある方には、最高のGodot MCPサーバーのまとめが実際の選択肢を比較し、それぞれの限界を率直に説明しています。またGodotのベストAIツールガイドは広い視野でその全体像をカバーしています。外部サーバーを使わずAIがすでにエンジン内に組み込まれた環境で作業したい方は、Summer Engineをダウンロードして無料で始められます。お好みのジャンルのテンプレートからスタートするのがおすすめです。

Frequently asked questions

Godot MCPをわかりやすく言うと?

Godot MCPは、AIクライアントをツールに接続するためのオープン標準であるModel Context Protocolを使って、AIアシスタントをGodotプロジェクトに組み込む仕組みです。Godot MCPサーバーがクライアント(Cursor、Claude Desktopなど)と並行して動作し、AIにシーンツリーの読み取り、スクリプトの参照、ファイルの編集といったツールを提供します。これにより、AIは貼り付けたテキストから推測するのではなく、実際のプロジェクトを直接理解できるようになります。まとめると、MCPは配線、サーバーはアダプター、その結果としてAIがGodotプロジェクトを直接参照・編集できるようになります。

Godot MCPサーバーでAIに何ができますか?

標準的なファイルレベルのGodot MCPサーバーでは、AIがプロジェクト構造の読み取り、.tscnシーンファイルのノード階層とシグナル接続の解析、.gdスクリプトの参照と書き換え、プロジェクト設定の読み取りができます。これでコード作業のほとんどはカバーできます。ただし、ゲームを実行させることはできません。エンジンレベルのサーバーはこれにランタイム側を加えます。稼働中のシーンツリーへのノード追加、再生ボタンの押下、ゲーム実行中のデバッガーや診断情報の読み取り、3D・画像・音声アセットの生成が可能になります。Summer Engineのホスト型MCPサーバーがエンジンレベルのオプションに該当します。ファイルを解析するのではなく、実際に動作しているエンジンへの橋渡しをするからです。

Godot MCPは無料ですか?

はい、プロトコル自体は無料でオープンです。コミュニティ製のGodot MCPサーバー(GDAI MCP、Coding-SoloのgodotMCP、bradypp、satelliteoflove)も無料のオープンソースです。これらはセルフホスト型で、継続的なコストはOpenAIやAnthropicを通じてクライアントが課金するAIモデルの計算コストのみです。サーバー自体には費用がかかりません。Summer EngineのホストMCPサーバーは接続も利用開始も無料で、上限を引き上げたり3D生成などの重い処理を解放したりする有料プランもあります。いずれの場合も、実際の料金メーターはモデルのトークン消費であり、MCPサーバーではありません。

GodotにはMCPが標準搭載されていますか?

標準のGodotにはMCPサーバーは同梱されていません。別のコミュニティプロジェクトとして追加するか、ホスト型のサーバーをクライアントに設定する必要があります。例外はAIネイティブなエンジンで、エージェントをエンジンに直接組み込んでいるものです。Summer EngineはGodot 4と互換性があり、AIエージェントがエンジン内部に組み込まれているため、外部MCPサーバーをインストールしなくても稼働中のシーンツリーを操作できます。また、CursorやClaude Codeのような外部クライアントからエンジンをリモート操作したい場合のために、Summerはホスト型MCPサーバーも公開しています。

Godot MCPはどのAIクライアントで使えますか?

MCPは共通標準であるため、同じGodot MCPサーバーが多くのクライアントで動作します。主なものはCursor、Claude Desktop、Claude Code、Windsurf、Clineで、一部のサーバーはCodex CLIやGemini CLIでも動作します。セットアップはクライアントの設定ファイルに小さなJSONエントリを追加するだけで、セルフホストのファイルレベルサーバーならローカルコマンドを、ホスト型なら単一URLを指定します。MCPが標準規格であることで、クライアントごとに個別のプラグインを書かずに一つのサーバーを複数のクライアントで再利用できます。

Godot MCPにできないことは何ですか?

ファイルレベルのGodot MCPサーバーは再生ボタンを押してゲームを実行することができません。スクリプトの読み書きや.tscnファイルの解析はできますが、レンダリング出力の確認、デバッガーのステップ実行、ランタイムの変数値の検査、物理的な挙動が適切かどうかの判断はできません。これがファイルレベルのブリッジが持つ根本的な限界であり、AIが編集したGDScriptが一見正しく見えてもランタイムで壊れてしまう理由です。Summer Engineのようなエンジンレベルの統合ではlocalhost上で実際のエンジンが動くため、シーンを実行し、ゲーム実行中に診断情報やデバッガー出力を読み取り、実際のエラーからGDScriptを自己修正することができます。