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

インストール

AI Game Devアプリ、godot-cli、Godot Asset Library、リリースzipでGodot MCPアドオンをインストールする方法と、.csprojに必要なNuGetパッケージを解説します。

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

このページでは、Godot C#プロジェクトにGodot MCPを追加するすべての方法と、それぞれが何をしてくれるのかを説明します。とにかく動かしたいだけなら、デスクトップアプリか godot-cli を使ってください。どちらもアドオンのインストール、.csproj の書き換え、プラグインの有効化を1ステップで行います。手動の方法（Asset Library、リリースzip）では、見落としやすい2つの追加手順が必要です。

要件

要件詳細
GodotGodot 4.3以降、.NET (mono) エディション。アドオンは最低バージョンとして Godot.NET.Sdk 4.3.0 を対象にビルドされており、プロジェクトのCIでは4.3、4.4、4.5、4.6、4.7で起動確認されています。
.NET.NET 8 SDK（net8.0）。
プロジェクトルートにC#の .csproj があるGodotプロジェクト。
godot-cli（任意）Node.js ^20.19.0 または >=22.12.0。
オペレーティングシステムWindows、macOS、Linux。

オプション1: AI Game Devデスクトップアプリ

AI Game Devアプリは、選択したプロジェクトにGodot MCPをインストールし、そのままアカウントに接続済みのエディタを開くことができます。インストーラのコピーを同梱しているため、Node.jsやnpmは不要です。アプリは常に最新リリースのアドオンをインストールし、godot-cli install-plugin と同じ3つの処理を行います。つまり、アドオンファイルを addons/godot_mcp/ に配置し、NuGetパッケージと拡張カタログを .csproj に追加し、project.godot でプラグインを有効化します。

アプリはダウンロードページからダウンロードできます。インストール方法とプロジェクトの選択方法はアプリのインストールに、アプリのコマンドラインについてはアプリCLIに記載されています。

オプション2: godot-cli（ターミナル）

godot-cli はGodot MCP用のnpmパッケージです。その install-plugin コマンドは完全なインストーラであり、再実行しても安全です。2回目以降の実行では何も変更されません。

npm install -g godot-cli
godot-cli install-plugin ./MyGodotProject

install-plugin が順番に行う処理:

  1. Godot-MCPのGitHubリリースから godot-mcp-addon-<version>.zip をダウンロードし（HTTPS、github.comのみ）、res://addons/godot_mcp/ に配置します。バージョンはデフォルトでCLI自身のバージョンになります。
  2. インストールしたアドオンが必要とするNuGetの PackageReference を、アドオン自身から取得したバージョンで .csproj に追加し、古いバージョンを修正します。
  3. 拡張カタログの <EmbeddedResource> を追加し、<EnableDynamicLoading>true</EnableDynamicLoading> を設定します。
  4. project.godot の [editor_plugins] セクションでプラグインを有効化します。

便利なバリエーション:

# A specific addon release
godot-cli install-plugin --version 0.34.0 ./MyGodotProject

# Offline or development install from a local copy of the addon
godot-cli install-plugin --source ./Godot-MCP/addons/godot_mcp ./MyGodotProject

# No project yet: scaffold a Godot C# project first
godot-cli create-project --dotnet ./MyGodotProject

グローバルインストールなしでも実行できます: npx godot-cli install-plugin ./MyGodotProject。すべてのフラグはgodot-cliリファレンスに記載されています。

オプション3: Godot Asset Library

  1. Godotエディタで、上部の AssetLib タブを開きます。
  2. Godot-MCP を検索し、アセットを開きます。
  3. Download をクリックし、次に Install をクリックします。Godotがアドオンを res://addons/godot_mcp/ に展開します。
  4. NuGetパッケージとカタログ行を .csproj に追加します（下記参照）。
  5. プラグインを有効化します（下記参照）。

Asset Libraryのエントリは常にタグ付きリリースを指しているため、動作が確認済みのスナップショットを入手できます。ただし含まれるのはアドオンファイルのみで、手順4と5は自分で行う必要があります。

オプション4: GitHubのリリースzipまたはソースのコピー

Godot-MCPのリリースページから godot-mcp-addon-<version>.zip をダウンロードし、プロジェクトのルートに展開します。アーカイブにはすでに addons/godot_mcp/ が含まれているため、ファイルは res://addons/godot_mcp/ に配置されます。リポジトリのクローンから addons/godot_mcp/ フォルダをコピーしてもかまいません。その後、下記の2つの手動ステップを行ってください。

手動ステップ: NuGetパッケージと拡張カタログ

Godotはプロジェクト内のすべての .cs ファイルを1つのアセンブリにコンパイルするため、.csproj はアドオンが使用するのと同じNuGetパッケージを参照している必要があります。参照がないとアドオンはコンパイルされません。以下を .csproj に追加してください（バージョンはアドオン0.34.0用です）:

<ItemGroup>
  <PackageReference Include="com.IvanMurzak.ReflectorNet" Version="5.5.1" />
  <PackageReference Include="com.IvanMurzak.McpPlugin" Version="8.14.0" />
</ItemGroup>

<!-- Editor-only: exported games ship no RQL and no Roslyn. -->
<ItemGroup>
  <PackageReference Include="com.IvanMurzak.Rql" Version="0.3.0" Condition="'$(Configuration)' != 'ExportDebug' and '$(Configuration)' != 'ExportRelease'" />
  <PackageReference Include="com.IvanMurzak.CodeExec" Version="0.4.0" Condition="'$(GodotMcpCodeExecInGame)' == 'true' or ('$(Configuration)' != 'ExportDebug' and '$(Configuration)' != 'ExportRelease')" />
  <PackageReference Include="com.IvanMurzak.CodeExec.Roslyn" Version="0.4.0" Condition="'$(GodotMcpCodeExecInGame)' == 'true' or ('$(Configuration)' != 'ExportDebug' and '$(Configuration)' != 'ExportRelease')" />
  <PackageReference Include="Microsoft.CodeAnalysis.CSharp" Version="4.12.0" Condition="'$(GodotMcpCodeExecInGame)' == 'true' or ('$(Configuration)' != 'ExportDebug' and '$(Configuration)' != 'ExportRelease')" />
</ItemGroup>

<!-- Without this line the dock's Extensions list is empty. -->
<ItemGroup>
  <EmbeddedResource Include="addons/godot_mcp/extensions.catalog.json" LogicalName="Godot-MCP.extensions.catalog.json" />
</ItemGroup>
パッケージバージョン（アドオン0.34.0）役割
com.IvanMurzak.ReflectorNet5.5.1リフレクションとシリアライズの中核
com.IvanMurzak.McpPlugin8.14.0エディタをサーバーに接続するMCPクライアント
com.IvanMurzak.Rql0.3.0エディタツールを支えるクエリ言語RQL（エディタ専用）
com.IvanMurzak.CodeExec0.4.0script-execute 用にC#スニペットを実行（オプトインしない限りエディタ専用）
com.IvanMurzak.CodeExec.Roslyn0.4.0Code-Exec用のRoslynアダプタ
Microsoft.CodeAnalysis.CSharp4.12.0Roslyn C# コンパイラ

バージョンは、インストールしたアドオンと一致している必要があります。各リリースの README にそれらが記載されており、リリースの zip には addons/godot_mcp/nuget-deps.json として含まれています。godot-cli install-plugin はこのファイルを読み込むため、バージョンを間違えることはありません。開発ブランチではすでに com.IvanMurzak.McpPlugin が先に進んでいる（8.18.0）ので、更新する際は再度確認してください。

また、.csproj の <PropertyGroup> に <EnableDynamicLoading>true</EnableDynamicLoading> を残しておいてください。Godot 標準の C# テンプレートにも含まれています。これがないと、Play で起動したゲームでは C# スクリプトを一切作成できません。

DLL をコピーする必要はありません。dotnet restore を実行する（または Godot からビルドする）だけで、エディタ実行時にアドオンが NuGet キャッシュ内のパッケージを見つけます。

手動ステップ: プラグインを有効にする

Project, Project Settings, Plugins を開き、Godot-MCP を有効にします。C# プロジェクトをビルドします（エディタの Build ボタン、または godot-cli build）。読み込みに成功すると、Output パネルに次のように表示されます:

[Godot-MCP] plugin loaded

AI Game Developer ドックが右上のドックエリアに表示されます。はじめに に進んでください。

更新と削除

  • インストール時と同じツールで更新します。godot-cli install-plugin を再実行する（任意で --version を指定）、アプリを使う、または Asset Library から新しいリリースをインストールして NuGet のバージョンを手動で更新します。
  • CLI 自体は godot-cli update で更新します。
  • godot-cli remove-plugin ./MyGodotProject は project.godot 内でアドオンを無効にします。addons/godot_mcp/ や .csproj のエントリは削除されません。不要であれば手動で削除してください。

エクスポートしたゲーム

RQL、Code-Exec、Roslyn の各パッケージには Condition が設定されており、ExportDebug および ExportRelease ビルドから除外されるため、エクスポートしたゲームに同梱されることはありません。アドオンのエディタツールはエディタ内でのみコンパイルされ、ゲームビルドには含まれません。実行中のゲームからツールを公開するかどうかはオプトインであり、カスタムツール で説明されています。