영어 버전 | 티앙 비엣

Unity Editor を AI エージェントに開放するフレームワークです。 人が手で実行しても、スクリプトから呼んでも、同じ経路を通ります。

• MCP 클라이언트는 , Editor 自身가 공개하는 Streamable HTTP 엔드포인트 http://127.0.0.1: /mcp に直接연결합니다. 다른 프로세스의 MCP 서버はありません。 Claude Code, Cursor, Codex, Gemini CLI, VS Code, Claude Desktop で동작を確認しています.
• コマンドラインの isuzu-unity-cli からも同じツールを呼べます。 配布している실행파일은 네이라인なので、Node も .NET ランタイムも要りません。
• ツール는 C# の static メソッドに [McpTool] を付けるだけで定義できます。

는 じめて使う方는 , 図つきの도입가이드 Unity MCP のはじめかた から始めてください。

必要条件

• Unity Editor 2022.3 以降. EditMode 테스트スイート는 Unity 6000.0.35f1 에서 실행하고 있습니다
• Git 클라이언트 2.14.0 以降を PATH に通しておいてください。 Unity の Package Manager が git URL のパッケージを取得するのに使います(Unity のマニュアル). 下の VPM リポジトリから入れる場合は要りません
• com.unity.nuget.newtonsoft-json 3.2.1. 依存として自動で解決されます

インストール

Unity の Package Manager で Add package from git URL を選び、次の URL を入力します.

VCC(VRChat Creator Companion)와 ALCOM では、VPM リポジトリ https://unity-mcp.shiranui-isuzu.dev/vpm.json を追加してください. 모두 패키지를 zip 에서 다운로드하는 ので、이 経路に Git は要りません。 ワンクリックで추가하는 링크와 , 추가하는 장소의 화면은 , 도입가이드の VCC・ALCOM をお使いの場合 にあります。

CLI をインストールします.

GitHub Releases から실행파일을 직접 다운로드해서 、SHA256SUMS 에서 검증することもできます。.NET 10 SDK があれば dotnet tool install -g IsuzuUnityCli でも入ります.

Unity MCP 統合フレームワーク

English Version | Tiếng Việt

Unity Editor を AI エージェントに開放するフレームワークです。人が手で実行しても、スクリプトから呼んでも、同じ経路を通ります。

• MCP クライアントは、Editor 自身が公開する Streamable HTTP エンドポイント http://127.0.0.1:/mcp に直接接続します。別プロセスの MCP サーバーはありません。Claude Code、Cursor、Codex、Gemini CLI、VS Code、Claude Desktop で動作を確認しています。
• コマンドラインの isuzu-unity-cli からも同じツールを呼べます。配布している実行ファイルはネイティブなので、Node も .NET ランタイムも要りません。
• ツールは C# の static メソッドに [McpTool] を付けるだけで定義できます。

はじめて使う方は、図つきの導入ガイド Unity MCP のはじめかた から始めてください。

必要条件

• Unity Editor 2022.3 以降。EditMode テストスイートは Unity 6000.0.35f1 で実行しています
• Git クライアント 2.14.0 以降を PATH に通しておいてください。Unity の Package Manager が git URL のパッケージを取得するのに使います（Unity のマニュアル）。下の VPM リポジトリから入れる場合は要りません
• com.unity.nuget.newtonsoft-json 3.2.1。依存として自動で解決されます

インストール

Unity の Package Manager で Add package from git URL を選び、次の URL を入力します。

https://github.com/isuzu-shiranui/UnityMCP.git?path=jp.shiranui-isuzu.unity-mcp

VCC（VRChat Creator Companion）と ALCOM では、VPM リポジトリ https://unity-mcp.shiranui-isuzu.dev/vpm.json を追加してください。どちらもパッケージを zip でダウンロードするので、この経路に Git は要りません。ワンクリックで追加するリンクと、追加する場所の画面は、導入ガイドの VCC・ALCOM をお使いの場合 にあります。

CLI をインストールします。

# Windows
irm https://raw.githubusercontent.com/isuzu-shiranui/UnityMCP/main/install.ps1 | iex

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/isuzu-shiranui/UnityMCP/main/install.sh | sh

GitHub Releases から実行ファイルを直接ダウンロードして、SHA256SUMS で検証することもできます。.NET 10 SDK があれば dotnet tool install -g IsuzuUnityCli でも入ります。

続けて、エージェント用のスキルと MCP クライアントを登録します。

isuzu-unity-cli setup                              # Claude Code / Codex 向けのスキル
isuzu-unity-cli setup --mcp --agent claude-code    # MCP クライアントへの登録

--agent は claude-code / claude-desktop / codex / cursor / gemini / vscode から選べます。Claude Code はサーバーを Unity プロジェクトのパスの下に登録するので、Claude Code を Unity プロジェクトのフォルダーで起動してください。Editor の Preferences > Unity MCP ページからも登録できます。

クライアントごとの設定、Claude Desktop 向けの拡張機能バンドルと stdio ブリッジは MCP クライアントの接続 にあります。

最初のコマンド

Editor がプロジェクトを開くとサーバーが起動し、descriptor ファイルを公開します。CLI はそれを読むので、ポートやトークンの指定は要りません。

isuzu-unity-cli projects                  # 起動中の Editor 一覧
isuzu-unity-cli tools                     # 利用可能なツール
isuzu-unity-cli call play_mode_status     # ツールの実行
isuzu-unity-cli verify                    # 再コンパイル → エラー抽出 → コンソールのエラー

verify は、スクリプトを編集したあとの再コンパイルとエラー収集を 1 回の呼び出しにまとめます。--test を付けるとテストも実行します。