このページは英語から機械翻訳されています。英語の原文を読む。

Godot MCP

Godot MCPはClaude、Cursor、CopilotなどのAIエージェントをGodotエディタに接続します。インストール、セットアップ、ツール、拡張機能、CLIはここから始めましょう。

2026年11月4日に更新 Markdownで表示

Godot MCPはAI Game DeveloperのGodotアドオンです。Claude Code、Cursor、GitHub Copilot、Codex、GeminiなどのAIエージェントがGodotエディタ内で作業できるようにします。シーンツリーの照会と編集、.tscnシーンのオープンと保存、.tresリソースやプロジェクト設定の変更、C#とGDScriptファイルの読み書き、C#プロジェクトのビルド、エディタ内でのC#スニペットの実行、モデルが確認できるスクリーンショットの取得が可能です。このwikiでは、インストール方法、AIクライアントへの接続方法、日々の使い方を説明します。

Godot MCPとは

Godot MCPはC#製のエディタアドオン（フォルダー addons/godot_mcp/、Project SettingsではGodot-MCPとして表示）で、Godot 4の.NETプロジェクト内で動作します。エディタがこれを読み込むと、アドオンはAI Game Developerというドックを開き、MCPサーバーに接続します。チャットするAIエージェントは同じサーバーに接続し、Model Context Protocol（MCP）を通じてアドオンのツールを呼び出します。

このアドオンはオープンソース（Apache-2.0）で、Godot-MCP リポジトリで公開されています。MCPライブラリとリフレクションライブラリをUnity MCPやUnreal MCPと共有しているため、3つのエンジンプラグインは同じように動作し、同じクラウドアカウントを使用します。

各要素の関係

要素役割
Godot MCPアドオンGodotエディタ内で動作し、AIツールを公開してMCPサーバーに接続します。
MCPサーバーai-game.devのクラウドサーバー（デフォルト）、または自分のマシンで実行する独自サーバー。
AIクライアントClaude Code、Cursor、VS Code Copilot、Codex、Gemini、その他のMCPクライアント。同じサーバーに接続します。
godot-cliアドオンのインストール、サインイン、AIクライアント設定の書き込み、エディタの起動を行うnpmコマンドラインツール。
AI Game Devアプリターミナルなしでアドオンのインストールとエディタの起動を行えるデスクトップアプリ。

デフォルトのクラウドモードでは、GodotとAIクライアント以外はマシン上で動作しません。エディタとエージェントの両方がホストされたエンドポイントに接続し、ai-game.devアカウントで一度サインインするだけです。カスタムモードでは、アドオンがローカルMCPサーバーをダウンロードして起動できるため、すべてが自分のコンピューター内で完結します。

必要なもの（概要）

  • Godot 4.3以降の.NET（mono）ビルド。標準のGDScript専用ビルドではこのアドオンをコンパイルできません。
  • .NET 8 SDK。
  • C#の.csprojを持つGodotプロジェクト。ゲームコード自体はGDScriptのままでも構いません。アドオンが自身をコンパイルするためにC#プロジェクトが必要なだけです。
  • MCPに対応したAIクライアント。

.csprojに必要なNuGetパッケージを含む完全なリストはインストールにあります。

クイックスタート

ターミナルに慣れているなら、以下のコマンドでGodotのC#プロジェクトをゼロから接続済みのAIエージェントまで持っていけます。

npm install -g godot-cli
godot-cli install-plugin ./MyGodotProject
godot-cli login
godot-cli setup-mcp claude-code ./MyGodotProject
godot-cli open ./MyGodotProject

次に、エージェントに「Camera3DとMeshInstance3Dのキューブを備えたNode3Dシーンを追加し、Main.tscnとして保存して」のように依頼します。はじめにページでは同じ手順を解説付きで説明しており、サイトのクイックスタートでは3つのエンジンすべてを扱っています。

このwikiのページ

  • インストール：すべてのインストール方法（デスクトップアプリ、godot-cli、Asset Library、リリースzip）と必要なNuGetパッケージの正確な内容。
  • はじめに：最初の接続、最初のプロンプト、すべてが正常に動作しているかの確認方法。
  • AIクライアントの接続：クラウドエンドポイントと独自サーバーの違い、デバイスサインイン、プロジェクトキー、各エージェント向けのsetup-mcp。
  • 設定：AI Game Developerドック、保存される設定、GODOT_MCP_*環境変数。
  • ツール：組み込みのツールファミリー、RQL、各ツールの用途。
  • カスタムツール：C#で独自のMCPツールを作成し、実行中のゲームからツールを公開する方法。
  • 拡張機能：アニメーション、CSG、ナビゲーション、タイルマップ、および人気のGodotアドオン向けの任意パッケージ。
  • godot-cliリファレンス：すべてのgodot-cliコマンドとそのフラグ。
  • トラブルシューティング：アドオンが読み込まれない、エージェントにツールが見えない、リロードの問題。
  • FAQ：よくある質問への簡潔な回答。

サイトのその他の情報