VS CodeからプロンプトでUnityを操作！unity-mcpを使ってみた

概要

この記事では、プロンプトを使ってUnityエディタを操作できるツール「unity-mcp」について紹介します。unity-mcpを使うと、自然言語で指示を出すだけでUnityの操作が可能になります。VS Codeから簡単に試せるのが面白かったので、基本的な使い方やVS Codeでの設定方法、使う上での注意点などをまとめてみました。

Model Context Protocol (MCP) とは？

まず、unity-mcp を理解する上で前提となる Model Context Protocol (MCP) について簡単に触れておきましょう。

MCPは、大規模言語モデル（LLM）が外部ツールやアプリケーションと対話するためのプロトコル（通信規約）です。これにより、LLMは単にテキストを生成するだけでなく、特定のソフトウェアを操作したり、外部のAPIを利用したりできるようになります。

unity-mcp は、このMCPを利用して、LLMがUnityエディタを操作できるようにした実装の一つ、というわけですね。

unity-mcpとは？

unity-mcpは、自然言語のプロンプト（指示）を使ってUnityエディタを操作できるようにするツールです。例えば、「赤いキューブをシーンに追加して」といった指示で、実際にUnity上にオブジェクトを配置したりできます。

詳しい情報やセットアップ方法は、以下のGitHub リポジトリで確認できます。

https://github.com/justinpbarnett/unity-mcpgithub.com

基本的な使い方は、リポジトリのREADMEに沿ってセットアップし、サーバーを起動した後、対応するクライアント（VS Code 拡張機能など）からプロンプトを送るだけです。

Unity側の準備：パッケージの導入

VS Codeなどのクライアントから接続する前に、Unityプロジェクト側にunity-mcpのブリッジとなるパッケージを導入しておく必要があります。

1. Unityエディタを開き、対象のプロジェクトを開きます。
2. メニューバーから Window Package Manager を選択して、Package Managerウィンドウを開きます。
3. Package Managerウィンドウ左上の「+」ボタンをクリックし、「Add package from git URL...」を選択します。
4. 以下のURLを入力し、「Add」ボタンをクリックします。

https://github.com/justinpbarnett/unity-mcp.git?path=/UnityMcpBridge

5. パッケージのインポートが完了するまで待ちます。

これで、Unityプロジェクトがunity-mcpサーバーからの指示を受け付ける準備ができました。

VS Codeでの設定

VS Codeでunity-mcpを使う場合、拡張機能の設定が必要です。settings.json に以下のような設定を追加します。

"unity-mcp": {
    "command": "uv", // もしくは python など、サーバー起動に使うコマンド
    "args": [
        "--directory",
        "/path/to/your/UnityMCP/UnityMcpServer/src", // サーバーのソースコードがあるディレクトリパスに変更してください
        "run",
        "server.py" // サーバー起動スクリプト
    ]
}