拡張機能
Unity MCPの拡張機能は、Animation、Cinemachine、Input System、Navigation、ProBuilder、Splines、Terrain、Tilemap、Timeline、パーティクルに対するAIサポートを追加します。
拡張機能は、Cinemachineのカメラ、ProBuilderのメッシュ、2Dタイルマップなど、特定のUnity機能をAIエージェントに教えるためのオプションのUnityパッケージです。プロジェクトで使うものだけをインストールしてください。このページでは、10個の公式拡張機能、それぞれが追加する内容、そしてインストール方法を説明します。各拡張機能には、Unity extensions catalog内の詳細ページもあります。
拡張機能の仕組み
Unity MCP 1.0.0（および拡張機能バージョン2.0.0）以降、拡張機能は新しいMCPツールを追加しません。代わりにRQLモジュールを提供します。これは既存のrql-queryおよびrql-mutateツールが理解できる新しいソース、関数、型アダプターです。エージェントのツールリストのサイズは変わらず、拡張機能のガイドは生成されるunity-rqlスキルに追加されるため、パッケージをインストールしてスキルを再生成すれば、エージェントはすぐに新しい構文を学習します。
たとえば、AI Tilemapをインストールすると、エージェントはRQL経由でタイルを描画できます。
objects | get components | where $ is Tilemap | call BoxFill("Assets/Tiles/Grass.asset", -5, -3, 5, 3)各拡張機能はコアプラグインcom.ivanmurzak.unity.mcpと、その土台となるUnityパッケージに依存しています。インストールすると両方が取り込まれます。すべてUnity 2022.3以降をサポートしています。
公式拡張機能
| 拡張機能 | パッケージID | 基盤となるパッケージ | RQLの追加内容 |
|---|---|---|---|
| AI Animation | com.ivanmurzak.unity.mcp.animation | Animationモジュール | animationソース、AnimationClip、AnimatorController、Animator型 |
| AI Cinemachine | com.ivanmurzak.unity.mcp.cinemachine | com.unity.cinemachine | cinemachineソース、CinemachineCamera、CinemachineBrain |
| AI InputSystem | com.ivanmurzak.unity.mcp.inputsystem | com.unity.inputsystem | inputソース、InputActionAsset |
| AI Navigation | com.ivanmurzak.unity.mcp.navigation | com.unity.ai.navigation | navigationソース、NavMeshSurface、NavMeshLink、NavMeshAgent |
| AI Particle System | com.ivanmurzak.unity.mcp.particlesystem | Particle Systemモジュール | ParticleSystemとそのモジュール、カーブ、グラデーション |
| AI ProBuilder | com.ivanmurzak.unity.mcp.probuilder | com.unity.probuilder | probuilderソースと関数、ProBuilderMesh |
| AI Splines | com.ivanmurzak.unity.mcp.splines | com.unity.splines | splinesソース、SplineContainer |
| AI Terrain | com.ivanmurzak.unity.mcp.terrain | Terrainモジュール | terrainソース、高さ関数、Terrain、TerrainData |
| AI Tilemap | com.ivanmurzak.unity.mcp.tilemap | Tilemapモジュールと2D Tilemap Extras | tilemapソースと関数、Tilemap、RuleTile |
| AI Timeline | com.ivanmurzak.unity.mcp.timeline | com.unity.timeline | timelineソース、TimelineAsset、トラック、クリップ、PlayableDirector |
各モジュールの正確なソース、関数、呼び出しは、それぞれのカタログページおよびエディター内のrql-schemaにあります。
AI Game Developerウィンドウからインストールする
- Window > AI Game Developer — MCPを開きます。
- Extensionsまでスクロールします。
- 目的の拡張機能の横にあるInstallをクリックします。
このウィンドウは、OpenUPMのスコープ付きレジストリとパッケージを、OpenUPM上の最新バージョンでPackages/manifest.jsonに追加します。その後、Unityが解決してインポートします。
unity-mcp-cliでインストールする
unity-mcp-cli install-extension --list
unity-mcp-cli install-extension Tilemap ./MyUnityProjectidにはカタログ名（Tilemap、Cinemachine、ProBuilderなど）またはパッケージID（com.ivanmurzak.unity.mcp.tilemap）を指定でき、大文字と小文字は区別されません。パスはデフォルトでカレントフォルダーになります。このコマンドは最新のOpenUPMバージョンを解決し、インストール済みのより新しいバージョンをダウングレードすることはなく、拡張機能がすでに最新の場合は何も行いません。バージョンを固定するには--extension-version <version>を使います（CLIのバージョンを表示する--versionではありません）。その後、Package Managerが解決できるようにUnityを開くかフォーカスしてください。
OpenUPMでインストールする
openupm add com.ivanmurzak.unity.mcp.cinemachineUnity-MCPリポジトリにある各拡張機能のREADMEには、その拡張機能用の.unitypackageインストーラーへのリンクもあり、コアインストーラーと同じように動作します。
デスクトップアプリでインストールする
AI Game Devアプリでも、開いているプロジェクトにUnity拡張機能をインストールできます。コアプラグインのバージョンとは独立した、各拡張機能自身のOpenUPMバージョンを使用します。詳しくはアプリのドキュメントを参照してください。
インストール後
- スキルを再生成します（ウィンドウのSkills > Generate、または
unity-mcp-cli setup-skills <agent>）。これにより、エージェントのunity-rqlスキルに新しいモジュールが含まれます。 - エージェントが新しい型を認識していないようであれば、
rql-schemaから始めるよう依頼してください。たとえば「rql-schemaを使ってcinemachineソースが何を提供しているか確認し、Player用のフォローカメラを追加して」のように伝えます。 tilemap-set-tileやcinemachine-camera-createなど、古いチュートリアルのツール名はもう存在しません。各拡張機能のREADMEに、それらに対応するRQLの書き方が示されています。
更新と削除
拡張機能はコアプラグインとは別にバージョン管理されています。更新はPackage Managerで行うか、install-extensionを再実行します。削除は他のパッケージと同じくPackage Managerから行います。コアプラグインと拡張機能は、対応する現行バージョンをそろえて使ってください。拡張機能は必要とするコアの最低バージョンを宣言しています。
独自の拡張機能を作る
プロジェクトのコードから直接ツールを追加することも（カスタムツールを参照）、カスタムRQLアダプターで独自の型をRQLに教えることもできます。リポジトリの拡張機能ガイドでは、公式拡張機能の構築方法とテスト方法を説明しています。