Ollama 統合による Unity MCP

Ollamaを介してUnityとローカルの大規模言語モデル（LLM）間のシームレスな通信を可能にするUnity MCP（モデルコンテキストプロトコル）パッケージ。このパッケージはjustinpbarnett/unity-mcpを拡張してローカルLLMと連携させ、開発者がクラウドベースのLLMに依存せずにワークフローを自動化し、アセットを操作し、Unityエディターをプログラムで制御できるようにします。

概要

Ollama 統合を備えた Unity MCP は、次の間の双方向通信チャネルを提供します。

1. Unity（C#経由）

2. Python MCPサーバー

3. Ollamaを通じて運営されるローカルLLM

これにより、次のことが可能になります。

• アセット管理: Unity アセットをプログラムで作成、インポート、操作します

• シーンコントロール: シーン、オブジェクト、およびそのプロパティを管理します

• マテリアル編集: マテリアルとそのプロパティを変更します

• スクリプト統合: Unity スクリプトの表示、作成、更新

• エディター自動化:Unity エディターの元に戻す、やり直し、再生、ビルドなどの機能を制御します。

すべては独自のローカル LLM によって実行され、インターネット接続や API キーは必要ありません。

Related MCP server: Unity MCP Server

サポートされているモデル

この実装は、次の Ollama モデルで動作するように特別に構成されています。

• deepseek-r1:14b - 強力な推論機能を備えた140億パラメータモデル

• gemma3:12b - 優れた汎用性を備えたGoogleの120億パラメータモデル

Unity MCP ウィンドウでこれらのモデルを簡単に切り替えることができます。

インストール（資産方式）

Unity のパッケージ マネージャーの互換性の問題により、インストールにはAsset Methodを使用することをお勧めします。

前提条件

• Unity 2020.3 LTS以降

• Python 3.10以降

• システムにOllamaがインストールされている

• 次の LLM モデルが Ollama に取り込まれました:

  • ollama pull deepseek-r1:14b

  • ollama pull gemma3:12b

ステップ1: エディタースクリプトをダウンロードしてインストールする

1. このリポジトリをダウンロードまたはクローンします:

   git clone https://github.com/ZundamonnoVRChatkaisetu/unity-mcp-ollama.git

2. Unity プロジェクトの Assets ディレクトリにフォルダーを作成します。

   Assets/UnityMCPOllama

3. クローンしたリポジトリからEditorフォルダーを Unity プロジェクトにコピーします。

   # Copy the entire Editor folder
   [Repository]/Editor → Assets/UnityMCPOllama/Editor

4. フォルダ構造が正しいことを確認します。

   Assets/
     UnityMCPOllama/
       Editor/
         MCPEditorWindow.cs
         UnityMCPBridge.cs

5. Unityでスクリプトをインポートしてコンパイルする

ステップ2: Python環境の設定

1. Python 環境用のフォルダーを作成します (Unity プロジェクトの外部)。

   mkdir PythonMCP
   cd PythonMCP

2. クローンしたリポジトリから Python フォルダをコピーします。

   cp -r [Repository]/Python .

3. 仮想環境を作成してアクティブ化します。

   # Create a virtual environment
   python -m venv venv
   
   # Activate the virtual environment
   # On Windows:
   venv\Scripts\activate
   # On macOS/Linux:
   source venv/bin/activate

4. 依存関係をインストールします:

   cd Python
   pip install -e .

ステップ3: Ollamaを設定する

1. Ollamaがシステムにインストールされ、実行されていることを確認してください

2. サポートされているモデルをプルします。

   ollama pull deepseek-r1:14b
   ollama pull gemma3:12b

3. Ollama サーバーを起動します。

   ollama serve

OllamaでUnity MCPを使用する

ステップ1：Unity Bridgeを起動する

1. Unityプロジェクトを開く

2. Window > Unity MCPに移動して、MCP ウィンドウを開きます。

3. **「ブリッジを開始」**ボタンをクリックしてUnityブリッジを開始します

ステップ2: Pythonサーバーを起動する

1. コマンドプロンプトまたはターミナルを開きます

2. Python 環境に移動します。

   cd PythonMCP

3. 仮想環境をアクティブ化します。

   # On Windows:
   venv\Scripts\activate
   # On macOS/Linux:
   source venv/bin/activate

4. Python ディレクトリに移動してサーバーを起動します。

   cd Python
   python server.py

ステップ3: Ollamaの設定を構成する

1. Unity MCPウィンドウで、 Ollama Configurationセクションを見つけます。

2. 次の設定を確認または更新します。

   • ホスト: localhost (デフォルト)

   • ポート: 11434 (デフォルト)

   • モデル: deepseek-r1:14bまたはgemma3:12bのいずれかを選択してください

   • 温度：必要に応じて調整します（0.0～1.0）

3. Ollama構成の適用をクリック

ステップ4: チャットインターフェースを使用する

1. Unity MCPウィンドウの**「チャットインターフェースを表示」**ボタンをクリックします。

2. メッセージ欄に指示を入力してください

3. リクエストを処理するには**[送信]**をクリックしてください

プロンプトの例:

• 「位置 (0, 1, 0) に赤い立方体を作成します」

• 「シーンに球体を追加し、青いマテリアルを適用する」

• 「現在のシーン内のすべてのオブジェクトを一覧表示する」

• 「簡単な動作スクリプトを書いてキューブに添付する」

接続ステータスインジケーター

Unity MCP ウィンドウには、各コンポーネントのステータス情報が表示されます。

• Pythonサーバーステータス: Pythonサーバーが実行中かどうかを示します

  • 緑: 接続済み

  • 黄色: 接続されていますが、問題があります

  • 赤: 接続されていません

• Unityブリッジステータス: Unityソケットサーバーが実行中かどうかを表示します

  • 実行中: Unity は接続を待機しています

  • 停止: Unity ソケット サーバーがアクティブではありません

• Ollamaステータス: Ollamaへの接続ステータスを表示します

  • 接続済み: Ollama サーバーに正常に接続されました

  • 接続されていません: Ollama に接続できません

トラブルシューティング

よくある問題

1. Python サーバーの「未接続」ステータス

   • Python サーバーが実行中であることを確認します ( python server.py )

   • Pythonコンソールでエラーを確認する

   • Unity Bridgeが動作していることを確認する

2. Unity MCP メニューが見つかりません

   • エディタースクリプトがプロジェクトに正しくインポートされていることを確認してください

   • Unityコンソールでエラーがないか確認する

   • 必要に応じてUnityを再起動します

3. Ollama 接続の問題

   • ollama serveでOllamaが動作していることを確認する

   • モデルが適切に引き出されているか確認する

   • ファイアウォールがポート11434をブロックしていないことを確認する

4. MCPコマンド実行失敗

   • 詳細なエラーメッセージについてはPythonコンソールを確認してください

   • Unity Bridgeが動作していることを確認する

   • プロンプトが明確かつ具体的であることを確認してください

Python環境の明示的なセットアップ手順

Python 環境の設定中に問題が発生した場合:

1. Python 3.10以降をインストールする

2. ollama.aiからOllamaをインストールする

3. Python 環境専用のディレクトリを作成します。

   mkdir C:\PythonMCP
   cd C:\PythonMCP

4. このリポジトリをクローンまたはダウンロードし、Python フォルダーをコピーします。

   git clone https://github.com/ZundamonnoVRChatkaisetu/unity-mcp-ollama.git
   copy unity-mcp-ollama\Python .

5. 仮想環境を作成します。

   python -m venv venv

6. 仮想環境をアクティブ化します。

   venv\Scripts\activate

7. 依存関係をインストールします:

   cd Python
   pip install -e .

8. サーバーを実行します。

   python server.py

パフォーマンスに関する考慮事項

ローカル LLM のパフォーマンスはハードウェアによって異なります。

• deepseek-r1:14bの場合：推奨最小12GBのVRAM

• gemma3:12bの場合：推奨最小10GBのVRAM

• CPUのみの操作は可能だが、速度が大幅に低下する

貢献

貢献を歓迎します！お気軽にプルリクエストを送信したり、問題を報告してください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています。

謝辞

• justinpbarnett/unity-mcpをベースにしています

• ローカルLLM統合にOllamaを使用