unity-mcp-cli リファレンス

unity-mcp-cli は Unity MCP 用のコマンドラインツールです。Unity とプラグインのインストール、ai-game.dev へのサインイン、AI エージェント設定の書き込み、エディターの起動と終了、ターミナルや CI スクリプトからの MCP ツールの呼び出しやエディター内での C# 実行ができます。このページではバージョン 1.6.2 のすべてのコマンドとフラグを一覧で説明します。

インストール#

npm install -g unity-mcp-cli

または、インストールせずに任意のコマンドを実行できます: npx unity-mcp-cli <command>。Node.js ^20.19.0 または >=22.12.0 が必要で、Windows、macOS、Linux で動作します。エディターを管理するコマンドは Unity Hub CLI を使用します。Unity Hub がない場合、CLI がインストールします。

すべてのコマンドで利用できるグローバルオプション:

非対話ターミナル（CI）では、CLI はスピナーと色を自動的に無効化します。プロジェクトパスを受け取るほとんどのコマンドは、位置引数または --path として受け取り、デフォルトは現在のフォルダーです。

典型的なセッション#

unity-mcp-cli install-plugin ./MyGame
unity-mcp-cli login
unity-mcp-cli setup-mcp claude-code ./MyGame
unity-mcp-cli open ./MyGame
unity-mcp-cli wait-for-ready ./MyGame
unity-mcp-cli run-tool tests-run ./MyGame --input '{"testMode":"EditMode"}'
unity-mcp-cli close ./MyGame

プロジェクトセットアップコマンド#

install-unity#

Unity Hub 経由で Unity エディターをインストールします。引数を指定しない場合は最新の安定版リリースをインストールします。

create-project#

エディターで新しい Unity プロジェクトを作成します: unity-mcp-cli create-project ./MyGame --unity 6000.3.1f1。

install-plugin#

OpenUPM のスコープ付きレジストリと com.ivanmurzak.unity.mcp を Packages/manifest.json に追加します。インストール済みのより新しいバージョンをダウングレードすることはありません。フォルダーは Unity プロジェクトである必要があります。

install-extension#

公式拡張機能を Packages/manifest.json にインストールします。拡張機能を参照してください。

remove-plugin#

com.ivanmurzak.unity.mcp を Packages/manifest.json から削除し、スコープ付きレジストリは保持します。[path] を取ります（必須、または --path）。

configure#

UserSettings/AI-Game-Developer-Config.json 内のツール、プロンプト、リソースの表示・非表示を切り替えます。非表示の項目も、名前で呼び出せば実行されます。

bootstrap-local#

プロジェクトの設定を、指定したサーバー URL とトークンを使って Custom（ローカル）モードに固定します。冪等です。

サインインと AI エージェントのコマンド#

login#

ブラウザの OAuth デバイスフローで ai-game.dev にサインインし、認証情報を ~/.ai-game-dev/credentials.json に保存します。Editor プラグインとデスクトップアプリは同じ認証情報を使用します。すでにサインイン済みの場合は何もせず終了します。

setup-mcp#

AI エージェントの MCP 設定を書き出します。Editor ウィンドウの Configure と同じ出力です。デフォルトでは URL はこのプロジェクトに固定され（https://ai-game.dev/mcp/p/<pin>）、Cloud HTTP 設定の場合はサインイン済みであればこのプロジェクトのキーが含まれます。詳しくは AI クライアントの接続 を参照してください。

setup-skills#

実行中の Editor を介してエージェントのスキルファイルを生成します。Unity がプラグイン接続済みの状態で開かれている必要があります。

Editor コマンド#

open#

Unity Editor でプロジェクトを開き、指定したオプションからプラグインの接続用環境変数を設定します。エディターはデタッチ状態で起動します。

起動時エラーダイアログの自動消去には、macOS ではターミナルに対するアクセシビリティ権限が、Linux X11 では xdotool が必要です（Wayland はサポートされません）。

close#

プロジェクトの Editor を正常に終了します: unity-mcp-cli close ./MyGame --timeout 60 --force。実行されていない Editor を閉じても成功とみなされます。

wait-for-ready#

Editor と MCP サーバーがツール呼び出しを受け付けるまでポーリングします。オプション: [path]、--url、--token、--timeout <ms>（デフォルト 120000）、--interval <ms>（デフォルト 3000）。

status#

Unity が実行中かどうか、ローカル MCP サーバーが応答するかどうか、設定されたサーバー（たとえばクラウド）に到達可能かどうかを表示します。オプション: [path]、--url、--token、--timeout <ms>（デフォルト 5000）。

ツールコマンド#

run-tool#

サーバーの HTTP API 経由で MCP ツールを呼び出します。URL とトークンは、上書きしない限りプロジェクト設定（Custom または Cloud モード）から取得されます。

unity-mcp-cli run-tool rql-query ./MyGame --input '{"query":"objects | where name == \"Player\" | select path name active"}'
unity-mcp-cli run-tool unity-tool-list ./MyGame --raw

run-system-tool#

run-tool と同じオプションですが、MCP クライアントに公開されていないシステムツール（スキル生成やセッション制御など）向けです。

exec#

script-execute を介してエディター内で C# を実行し、結果を出力します。エディターが開いていればそれを使い、開いていなければ後続の呼び出しのためにウォームな状態を保つヘッドレスエディターを起動し、--idle 秒後に終了します。

unity-mcp-cli exec 'GameObject.FindObjectsOfType<Camera>().Length'
echo 'Application.unityVersion' | unity-mcp-cli exec

コンパイルエラーが発生すると終了コード 1 で終了し、該当する行を示します。

メンテナンス#

update#

CLI を最新の npm バージョンに更新します。--check は確認のみを行い、更新が利用可能な場合は終了コード 2 で終了します。npx 経由の場合は更新するものがありません。

ライブラリとしての利用#

このパッケージは型付きの Node.js API（installPlugin、removePlugin、configure、setupMcp、installExtension など）もエクスポートしており、出力の代わりに結果オブジェクトを返します。詳細はパッケージの npm の README を参照してください。

関連ページ#

• インストール と はじめに。
• open が設定する環境変数については 設定 を参照してください。
• デスクトップアプリ独自の CLI、gamedev: アプリ CLI。