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

拡張機能

AnimationPlayer、CSG、GridMap、ナビゲーション、パーティクル、TileMapLayer、Beehave、Dialogic、Phantom Camera、Terrain3D 向けのオプションの Godot MCP 拡張機能をインストールできます。

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

拡張機能は、Godot MCP に Godot のより多くの領域と、人気のある Godot アドオンに関する知識を与えるオプションの NuGet パッケージです。プロジェクトに必要なものだけをインストールしてください。このページでは、拡張機能の一覧、仕組み、そしてインストール方法 3 通りを説明します。各拡張機能の説明と例は、サイトの Godot 拡張機能 ページにあります。

拡張機能の仕組み

各拡張機能は RQL モジュールです。独自の MCP ツールは追加しません。その代わりに、コアの rql-query、rql-mutate、rql-schema ツールを新しいソース、検証済みのプロパティと呼び出しで拡張し、エージェントの godot-rql スキルにガイドを追加します。エージェントのツールリストのサイズは変わらず、エージェントは rql-schema を通して新しい領域を学びます:

rql-schema "Particles"

パッケージには C# ソースとビルド設定が含まれ、プロジェクト自身の GodotSharp に対してコンパイルされます。各拡張機能には独自のバージョンとリリースがあります。

利用可能な拡張機能

拡張機能パッケージ ID追加される内容必要条件
Animation Toolscom.IvanMurzak.Godot.MCP.AnimationAnimationPlayer のライブラリ、アニメーション、トラック、キーGodot 4.3+
Beehave Toolscom.IvanMurzak.Godot.MCP.Beehaveビヘイビアツリーとそのノードの一覧表示Beehave アドオン、Godot 4.3+
CSG Toolscom.IvanMurzak.Godot.MCP.CSG検証済みの CSG プリミティブの寸法と rootShapeGodot 4.3+
Dialogic Toolscom.IvanMurzak.Godot.MCP.Dialogicタイムラインとキャラクターの一覧表示・作成、タイムラインへのテキスト追加Dialogic アドオン、Godot 4.4+
GridMap Toolscom.IvanMurzak.Godot.MCP.GridMapGridMap の設定、セル行、セル編集Godot 4.3+
Navigation Toolscom.IvanMurzak.Godot.MCP.Navigation2D および 3D のナビゲーションエージェント、リージョン、リンク、リージョンベイクGodot 4.3+
Particles Toolscom.IvanMurzak.Godot.MCP.Particles2D および 3D の GPU パーティクル: 検証済みのエミッター設定と再起動Godot 4.3+
PhantomCamera Toolscom.IvanMurzak.Godot.MCP.PhantomCamera仮想カメラとホストの一覧表示、follow および look-at ターゲットの設定Phantom Camera アドオン、Godot 4.4+
Terrain3D Toolscom.IvanMurzak.Godot.MCP.Terrain3DTerrain ソース、リージョンサイズの変更、マテリアルの作成Terrain3D アドオン、Godot 4.4+
Tilemap Toolscom.IvanMurzak.Godot.MCP.TilemapTileMapLayer の使用済みセル行とセル編集Godot 4.3+

どの拡張機能にも、RQL ツールを含むコアアドオン（0.28.0 以降の任意のリリース）が必要です。

godot-cli でインストール

godot-cli install-extension com.IvanMurzak.Godot.MCP.CSG ./MyGodotProject
godot-cli build ./MyGodotProject

install-extension は、拡張機能カタログから ID を検索します。まずパッケージ ID で、次に名前で、大文字と小文字を区別せずに検索します（そのため "CSG Tools" も使えます）。そしてプロジェクトの .csproj 内の <PackageReference> を追加または更新します:

  • まだ参照されていない: 参照が追加されます。
  • 古いバージョンが参照されている: 更新されます。
  • すでに最新: 何も変わりません。

--version を指定しない場合、参照は NuGet の最新安定版リリースを指します（Version="*"）。正確なバージョンを指定するには --version <x.y.z> を使います。インストール後は、Godot がパッケージを復元してコンパイルできるようプロジェクトをビルドしてください。Godot には自動の復元ステップがありません。

ドックからインストール

AI Game Developer ドックの Extensions セクションには、同じカタログが Install と Update ボタン付きで表示されます。.csproj を CLI と同じ方法で編集します。その後で再ビルドしてください。ドックに .csproj が見つからないと表示される場合、アドオンが Godot の C# プロジェクト内にありません。

AI Game Dev アプリからインストール

Godot プロジェクトの場合、AI Game Dev アプリ のサイドバーに Extensions ボタンが表示され、これが同じカタログを開き、godot-cli と同じコードでインストールします。スラッシュコマンド /install-extension を使えば、アプリのチャットから同じことができます。引数なしならカタログを一覧表示し、ID を指定すれば現在のプロジェクトにインストールします。エンジンの拡張機能は、アプリ自体のパッケージとは異なります。

拡張機能カタログ

拡張機能の一覧は、アドオンに同梱される addons/godot_mcp/extensions.catalog.json にあります。ドック、godot-cli、アプリはいずれもこの 1 つのファイルを読み込みます。ドックはコンパイル済みのプロジェクトから読み込むため、.csproj がこのファイルを埋め込む必要があります:

<ItemGroup>
  <EmbeddedResource Include="addons/godot_mcp/extensions.catalog.json" LogicalName="Godot-MCP.extensions.catalog.json" />
</ItemGroup>

godot-cli install-plugin とアプリはこの行を自動で追加します。手動でインストールした場合に Extensions 一覧が空なら、この行が欠けています。追加して再ビルドしてください。詳しくは インストール を参照してください。

拡張機能を使う

ビルド後は、あとは頼むだけです。たとえば、CSG Tools をインストールした状態では次のようになります:

  • "3x3x3のボックスを作成し、そこから半径1.8の球を減算するCSGコンバイナーを構築してください。"
  • "シーン内のすべてのCSGシェイプを、その操作とサイズとともに一覧表示してください。"

エージェントはrql-mutateでノードを作成し（呼び出しごとに1つの undo 可能なステップ）、rql-queryで結果を確認します。負の半径など無効な値が指定された場合、変更全体が失敗し、シーンは変更されません。

独自の拡張機能を作成する

Godot-MCPリポジトリには拡張テンプレート（templates/extension/）と、モジュールのビルド・テスト・リリースのためのモノレポガイドが含まれています。単発のプロジェクト用ツールであれば、カスタムツールをそのまま使うほうが簡単です。