nanora-unity-mcp の導入
nanora-unity-mcp は Unity のパッケージです。必要なのは Unity 2021.3 LTS 以降(Unity 6 で日常使用)だけ。キー入力のシミュレートを使うなら Input System パッケージ(1.4 以降)も入れてください。
入れ方を選ぶ
Section titled “入れ方を選ぶ”| 方法 | 手順 | 向いている人 |
|---|---|---|
| Git URL | Window > Package Manager > + > Add package from git URL… に下の URL を貼る | いつも最新版を使いたい人 |
| tarball(.tgz) | Releases か BOOTH から com.nanora.nanora-unity-mcp-<版>.tgz を落とし、Add package from tarball… で選ぶ |
版を固定したい人(おすすめ) |
| .unitypackage | 先に Add package by name… で com.unity.nuget.newtonsoft-json を入れ、Assets > Import Package > Custom Package… |
Assets に直接置きたい人 |
https://github.com/nanora-sama/nanora-unity-mcp.git?path=Assets/NanoraUnityMCP- Git URL と tarball は、必要なパッケージ(Newtonsoft JSON・Test Framework・uGUI)も自動で入ります。.unitypackage は入らないので、先に Newtonsoft JSON を入れてください。サンプルも含みません。
- .tgz はプロジェクトの外の、消さない場所に置いてください(Unity はその場所を参照し続けます)。
起動を確かめる
Section titled “起動を確かめる”サーバーは Editor と一緒に起動します。初回は Setup Wizard(Window > Unity MCP > Setup Wizard)が開きます。Window > Unity MCP Server に Running とポート番号が出ていれば準備完了です。
curl http://127.0.0.1:<PORT>/health返ってきた projectPath が今のプロジェクトなら、AI をつなぎましょう。
おすすめ設定
Section titled “おすすめ設定”- Setup Wizard の Optimize for MCP (Recommended): Unity が裏にあっても応答するようにします。AI はたいてい別のウィンドウから操作するので、ほぼ必須です。
configure_editorの actionoptimize_for_mcpでも同じです。 - 任意: Project Settings > Editor > Enter Play Mode Settings で Reload Domain を外すと、Play に入るときにサーバーが止まらなくなります。ドメインリロードを参照。
- 更新 — Git URL: Package Manager の Update。tarball: 新しい .tgz を同じ手順で選び直す。.unitypackage: 新しいものを上書きインポート。
- 削除 — Package Manager の Remove(.unitypackage は
Assets/NanoraUnityMCPを削除)。自動で作られた.mcp.jsonと.claude/skills/unity-*は、要らなければ手で消してください。