移行記録: unity-mcp-server から unity-cli へ 本ドキュメントは旧プロジェクト unity-mcp-server（Node.js）から現行の unity-cli（Rust）への移行で変更された事項を記録するものです。
パフォーマンス : Node.js ランタイムのオーバーヘッドを排除し、起動速度とメモリ効率を改善配布の簡素化 : npm に代わり cargo install による単一バイナリ配布プロトコルの簡素化 : MCP (JSON-RPC over stdio) を廃止し、直接 TCP 通信に変更
項目
旧 (unity-mcp-server)
新 (unity-cli)
言語
TypeScript / Node.js
Rust
エントリーポイント
src/index.tssrc/main.rs
パッケージマネージャ
npm
Cargo
配布
npm install
cargo install
項目
旧
新
プロトコル
MCP (Model Context Protocol)
直接 TCP
トランスポート
JSON-RPC over stdio
JSON over TCP
接続方式
ホストアプリが stdio でサーバを起動
CLI が TCP で Unity Editor に接続
旧 MCP 方式では、AI ホスト（Claude Desktop 等）が stdio 経由で MCP サーバを起動し、JSON-RPC メッセージをやり取りしていました。新方式では CLI が直接 Unity Editor の TCP サーバに接続するため、中間レイヤーが不要になりました。
旧変数名
新変数名
備考
UNITY_CLI_HOST / UNITY_CLI_HOSTUNITY_CLI_HOSTホスト名
UNITY_CLI_PORTUNITY_CLI_PORTポート番号
UNITY_CLI_TIMEOUT_MSUNITY_CLI_TIMEOUT_MSタイムアウト
互換性ポリシー : 旧 UNITY_CLI_* 環境変数は移行用エイリアスとしてサポートされています。新しい UNITY_CLI_* が設定されていない場合に旧変数が参照されます。新規運用では UNITY_CLI_* を使用してください。
項目
旧
新
リポジトリ名
unity-mcp-server
unity-cli
UPM パッケージ名
com.akiojin.unity-mcp-bridge
com.akiojin.unity-cli-bridge
C# 名前空間
Legacy Bridge namespace
UnityCliBridge
npm パッケージ
unity-mcp-server
― (廃止)
crates.io
―
unity-cli
Unity 側の UPM パッケージは引き続き同一リポジトリ内で管理されています。主な変更:
名前空間の変更 : Legacy Bridge namespace → UnityCliBridgeパッケージ名の変更 : com.akiojin.unity-mcp-bridge → com.akiojin.unity-cli-bridge通信方式 : 変更なし（TCP サーバとして動作する点は同一）コマンドハンドラ : 既存のツール群は UnityCliBridge 側へ引き継ぎ
旧リポジトリでは Node.js 側に組み込まれていた静的解析機能を、独立した C# LSP サーバとして再実装
lsp/ ディレクトリに配置.NET 10 を使用
項目
旧
新
テスト
npm test
cargo test + dotnet test
リリース
npm publish
cargo publish + GitHub Release
ワークフロー
―
.github/workflows/release.yml
MCP サーバモード : stdio 経由の JSON-RPC サーバ機能は廃止npm 関連ファイル : package.json, tsconfig.json, node_modules 等は削除
環境変数の更新 : 旧 MCP 系環境変数から UNITY_CLI_* へ順次更新してください。新規設定は UNITY_CLI_* のみを使用してください。UPM パッケージ URL の変更 : Unity Package Manager の Git URL をリポジトリ名の変更に合わせて更新してください。スクリプトの更新 : 旧 unity-mcp-server コマンドを使用しているスクリプトは unity-cli に置き換えてください。
ベースライン方針と差分棚卸しは gwt-spec ラベル付き GitHub Issue の Spec/Plan で継続管理します。