# インストール — Godot · AI Game Developer Wiki

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

このページは英語から機械翻訳されています。[英語の原文を読む](https://ai-game.dev/docs/wiki/godot/installation)。

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

## 要件

| 要件 | 詳細 |
| --- | --- |
| Godot | Godot 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。 |

**注意**

標準のGodotダウンロード（GDScriptのみ）ではアドオンをコンパイルできません。Godotの.NETビルドをダウンロードしてください。プロジェクトにまだ `.csproj` がない場合は、Godotから作成するか（Project, Tools, C#, Create C# solution）、`godot-cli create-project --dotnet` で新しいプロジェクトを生成してください。

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

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

アプリは[ダウンロードページ](https://ai-game.dev/ja/download)からダウンロードできます。インストール方法とプロジェクトの選択方法は[アプリのインストール](https://ai-game.dev/ja/docs/wiki/app/installation)に、アプリのコマンドラインについては[アプリCLI](https://ai-game.dev/ja/docs/wiki/app/cli)に記載されています。

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

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

```bash
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]` セクションでプラグインを有効化します。

便利なバリエーション:

```bash
# 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リファレンス](https://ai-game.dev/ja/docs/wiki/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のリリース](https://github.com/IvanMurzak/Godot-MCP/releases/latest)ページから `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用です）:

```xml
<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.ReflectorNet` | 5.5.1 | リフレクションとシリアライズの中核 |
| `com.IvanMurzak.McpPlugin` | 8.14.0 | エディタをサーバーに接続するMCPクライアント |
| `com.IvanMurzak.Rql` | 0.3.0 | エディタツールを支えるクエリ言語RQL（エディタ専用） |
| `com.IvanMurzak.CodeExec` | 0.4.0 | `script-execute` 用にC#スニペットを実行（オプトインしない限りエディタ専用） |
| `com.IvanMurzak.CodeExec.Roslyn` | 0.4.0 | Code-Exec用のRoslynアダプタ |
| `Microsoft.CodeAnalysis.CSharp` | 4.12.0 | Roslyn 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 パネルに次のように表示されます:

```text
[Godot-MCP] plugin loaded
```

**AI Game Developer** ドックが右上のドックエリアに表示されます。[はじめに](https://ai-game.dev/ja/docs/wiki/godot/getting-started) に進んでください。

## 更新と削除

- インストール時と同じツールで更新します。`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` ビルドから除外されるため、エクスポートしたゲームに同梱されることはありません。アドオンのエディタツールはエディタ内でのみコンパイルされ、ゲームビルドには含まれません。実行中のゲームからツールを公開するかどうかはオプトインであり、[カスタムツール](https://ai-game.dev/ja/docs/wiki/godot/custom-tools) で説明されています。

---

Source (HTML): https://ai-game.dev/ja/docs/wiki/godot/installation

Machine-translated (ja) from the English page: https://ai-game.dev/docs/wiki/godot/installation