←Back to Blog
·Summer Team

Godot MCPサーバー完全ガイド（2026年）

MCPサーバーがGodotで何をしてくれるのかを学び、利用可能なすべての選択肢を比較し、AIを活用したプロジェクトアシストを数分でセットアップする方法をご紹介します。

MCP（Model Context Protocol）は、AIモデルを外部ツールやデータソースに接続するためのオープン標準です。Godot開発者にとってこれは、AIコーディングアシスタントがGodotプロジェクトを直接読み書きできることを意味します。Claude、Cursor、Windsurfなど、MCP対応のツールはシーンファイルを検査し、スクリプトを読み、プロジェクト構造を理解し、的を絞った変更を行えます。

これまでChatGPTにコードをコピペして、結果を手作業で貼り付けていた人にとって、MCPはその摩擦を取り除いてくれます。どう動くのか、どんな選択肢があるのか、どのセットアップがあなたのワークフローに合うのかを見ていきましょう。

MCPがGodotで何をしてくれるか

MCPがなければ、AIアシスタントはあなたが貼り付けたものしか見えません。シーンにどんなノードがあるか、どのシグナルをつないだか、プロジェクト設定がどうなっているか、スクリプト同士がどう関係しているかを、AIは知りません。結果として、あなたは多くの手動コンテキスト設定をすることになります。「CharacterBody3Dに子ノードがこう並んでいて、スクリプトはこういう処理をしていて……」

MCPがあれば、AIアシスタントはプロジェクトに直接つながります。次のことができます。

  • プロジェクト構造を読む: すべてのフォルダ、シーン、スクリプト、リソースファイル。
  • シーンツリーを検査する: ノード階層、エクスポートされたプロパティ、シグナル接続を確認。
  • スクリプトを読んで変更する: 任意のGDScriptファイルを開き、プロジェクト内での文脈を理解し、変更を書き込む。
  • プロジェクト設定を確認する: 入力マッピング、オートロード、レンダリング設定。

実用上の違いは大きいです。プロジェクトをAIに説明する代わりに、「プレイヤーシーンを見てジャンプの物理を直して」と言えます。AIはシーンを読み、スクリプトを見つけ、ノードのセットアップを把握して変更します。

こう考えてみてください。MCPなしのAIはコードアシスタント。MCPありのAIはプロジェクトアシスタントになります。

Godot向けに利用できるMCPサーバー

GDAI MCP

Webサイト: gdaimcp.com

GitHub: オープンソース

GDAI MCPは現時点で最も洗練された選択肢です。きちんとしたWebサイト、明快なセットアップ手順、活発な開発が揃っています。

機能にはプロジェクト構造の読み取り、シーンファイルのパース、スクリプトへのアクセスと変更、プロジェクト文脈を踏まえたコード生成が含まれます。Claude Desktopや、その他のMCP対応クライアントに接続できます。

ドキュメントはClaude Desktop、Cursor、その他のクライアントのセットアップを網羅しています。MCPが初めてなら、オンボーディングがよく練られているのでここから始めるのが一番やさしいでしょう。

Coding-Solo/godot-mcp

GitHub: github.com/Coding-Solo/godot-mcp

stdio経由で接続するオープンソースのMCPサーバーです。基本的なプロジェクトの読み取りとファイル操作を提供します。機能セットはGDAI MCPより控えめですが、コードベースはきれいで、独自ツールを追加して拡張するのも容易です。

自分で理解して改造できる、軽量なものが欲しいなら良い選択肢です。

bradypp/godot-mcp

GitHub: github.com/bradypp/godot-mcp

シーンツリーの読み取りとスクリプト生成を備えたもう一つのオープンソースの選択肢です。コミュニティによって保守されており、定期的に更新されています。Coding-Solo版と似た機能を持ち、シーンファイルのパース方法やプロジェクトデータの公開方法にいくつかの違いがあります。

satelliteoflove/godot-mcp

GitHub: github.com/satelliteoflove/godot-mcp

Godot MCPのコンセプトに対する別のアプローチです。これらのコミュニティプロジェクトは進化のスピードが違うので、現状の機能セットはREADMEを確認してください。

Godot MCPのセットアップ方法（クイックスタート）

具体的な手順はサーバーやクライアントによって異なりますが、全体の流れはどれも同じです。

ステップ1: MCPサーバーをインストールする

ほとんどのGodot MCPサーバーはNode.jsまたはPythonのパッケージです。リポジトリをクローンして依存関係をインストールします。

git clone https://github.com/example/godot-mcp
cd godot-mcp
npm install

ステップ2: MCPクライアントを設定する

Claude Desktopで設定を開き、MCPセクションに移動します。インストールしたパッケージを指す新しいサーバーエントリを追加します。

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

Cursorの場合、設定はプロジェクトの.cursor/mcp.jsonファイルにあります。フォーマットは同様です。

ステップ3: 接続してテストする

MCPクライアントを開き、プロジェクトについて何か聞いてみましょう。「このプロジェクトにはどんなシーンがありますか？」や「プレイヤーのスクリプトを見せて」などです。サーバーが正しく接続されていれば、AIはプロジェクトを読み、ファイルの実データをもとに応答します。

**ステップ4: 作業を始める

これでプロジェクトの文脈をフルに踏まえてAIに変更を依頼できます。

  • 「メインシーンに敵のスポナーを追加して」
  • 「プレイヤーのダッシュ能力が壁を貫通するバグがある。直して」
  • 「インベントリシステムをDictionaryの代わりにResourceを使うようリファクタして」

AIは関連するファイルを読み、文脈を理解し、既存のコードに合う変更を生成します。

ゲームにおけるMCPの限界

MCPはファイルレベルの統合です。これは理解しておく必要があります。AIアシスタントはGodotプロジェクトのファイルを読み書きできます。.tscnファイルをパースしてシーン構造を理解できます。.gdスクリプトを読み書きできます。

できないのは、動作中のエンジンとやり取りすることです。

MCPサーバーはプレイボタンを押してゲームの動作を見ることはできません。レンダリング出力を見ることもできません。物理的なインタラクションの感触が正しいかをテストすることもできません。フレームレートを観察したり、視覚的なグリッチを検出したり、パーティクルエフェクトが正しく見えるかを確認したりはできません。デバッガを一歩ずつ進めたり、ランタイムの変数値を調べたりもできません。

これがファイルレベルのブリッジとエンジンレベルの統合の根本的な差です。MCPはAIにプロジェクトのソースファイルへのアクセスを与えます。Summer EngineのようなAIネイティブなゲームエンジンはエンジンレベルで動作し、エンジンが実行されている最中に、AIがシーン、物理、レンダリング、ゲームプレイを理解します。ライブのエンジン文脈のなかで、ノードを作り、プロパティを調整し、挙動をテストできます。

コードレベルのタスク（スクリプトを書く、リファクタリング、バグ修正、ボイラープレートの生成）にはMCPがよく機能します。実際にゲームがどう遊ばれるかを理解する必要があるタスクには、より深い統合が必要です。

MCPが合う場面

MCPは次の場合に適しています。

  • すでにClaude、Cursor、あるいは他のMCP対応ツールを使っていて、Godotプロジェクトを理解させたい
  • ワークフローが主にコード中心で、スクリプト作成のためのより良い文脈が欲しい
  • 標準のGodotエディタでの作業を続けたい
  • 自分で検査・改造できるオープンソースのツールが好きだ

MCPがあまり向かないのは次のような場合です。

  • AIにシーンを読むだけでなく、作成・操作もしてほしい
  • AI生成アセット（3Dモデル、テクスチャ、アニメーション）が欲しい
  • AIにランタイムの挙動や物理を理解してほしい
  • 作りたいものを説明するとエンジンがそれを作ってくれる会話型のワークフローが欲しい

MCPの先へ

MCPは既存のAIツールにプロジェクトの文脈を持たせる賢いブリッジです。多くのGodot開発者にとって、まさに必要としているものです。

AIがエンジンそのものを理解する、より深い統合を求めるなら、Summer Engineは別のアプローチを取っています。外部のAIツールをGodotにつなぐのではなく、エンジンのコアにAIを直接組み込みます。その結果、シーンを作り、コードを書き、アセットを生成し、ゲームシステムを一つのまとまったワークフローとして理解するAIが得られます。そしてGodot 4 互換なので、既存のプロジェクトもそのまま使えます。

Godot AI統合ページで詳しく知るか、Summer Engineをダウンロードして試してみてください。