Unity Ollama

Unity MCPとOllamaの統合パッケージで、Unityとローカルの大規模言語モデルのシームレスな通信を実現し、アセット管理とエディタ自動化をサポートします。

開発者ツールゲームとゲーム化 #Unity自動化 #ローカルLLM #アセット管理 #エディタ制御 .Python

スコア : 2.5ポイント

ダウンロード数 : 6.4K

更新時間 : 2025-04-28

サイトを開く

Unity MCPとOllamaの統合とは何ですか？

Unity MCPとOllamaの統合は、Unityエディタを通じてローカルの大規模言語モデルと通信するツールです。これにより、開発者はクラウドサービスに依存することなく、アセットの作成、シーン管理、スクリプト作成を自動化できます。

Unity MCPとOllamaの統合をどのように使用しますか？

簡単な手順でUnityブリッジとPythonサーバーを起動し、ローカルモデルに命令を送信してタスクを処理します。

適用シーン

資産生成、シーン制御、スクリプト編集など、効率的なローカライズ自動化管理が必要なUnity開発プロジェクトに適しています。

主要機能

アセットの作成と管理

命令を通じてUnity内のアセットを自動的に作成および変更します。

シーン制御

シーン内のオブジェクトとその属性（位置、回転、スケールなど）を管理します。

マテリアル編集

マテリアルの属性（色、テクスチャ、透明度など）を変更します。

スクリプト統合

Unityスクリプトを表示、作成、更新します。

エディタ自動化

Unityエディタの機能（元に戻す、やり直す、再生、ビルドなど）を制御します。

利点

完全にローカルで実行され、インターネット接続が不要です。

DeepSeek - R1:14BやGemma3:12Bなど、複数の強力なローカルモデルをサポートします。

柔軟な自動化ワークフローで、開発効率を向上させます。

APIキーや有料サブスクリプションが不要です。

制限

高いビデオメモリを持つGPUなど、一定のハードウェアリソースが必要です。

モデルのパフォーマンスはハードウェア構成に制限される可能性があります。

一部の高度な機能には、より多くのカスタム設定が必要な場合があります。

使い方

インストールと設定

Unity MCPとOllamaの統合ツールをダウンロードしてインストールし、Ollamaモデルがインストールされていることを確認します。

Unityブリッジを起動する

Unityエディタを開き、ウィンドウメニューからUnity MCPを見つけ、「ブリッジを開始」をクリックします。

Pythonサーバーを起動する

仮想環境をアクティブ化し、Pythonサーバースクリプトを実行します。

使用例

赤色の立方体を作成する

命令を通じて指定された位置に赤色の立方体を作成します。

青色の球体を追加する

現在のシーンに青色の球体を追加します。

シーン内のオブジェクトをリストする

現在のシーン内のすべてのオブジェクトのリストを取得します。

よくある質問

なぜPythonサーバーが起動できないのですか？

異なるOllamaモデルを切り替えるにはどうすればいいですか？

Unityブリッジの接続が失敗した問題をどう解決しますか？

🚀 Unity MCP と Ollama の統合使用ガイド

本ガイドでは、UnityでMCPプロトコルを使用してOllamaを通じてローカルの大規模言語モデル（LLMs）を統合し、シーンオブジェクトの作成、スクリプトの追加、その他の操作を実現する方法を詳細に説明します。ドキュメントには、インストール手順、設定説明、使用方法、トラブルシューティングなどの内容が含まれています。

🚀 クイックスタート

本ガイドでは、UnityでMCPプロトコルを使用してOllamaを通じてローカルの大規模言語モデル（LLMs）を統合する方法を説明します。以下の手順に従って、インストール、設定、使用を行いましょう。

📦 インストール

システム要件

Python：3.10以上のバージョン
Ollama：ollama.aiからダウンロードしてインストールする必要があります
Unity Editor：正しくインストールされていることを確認してください

明示的な設定説明

プロジェクトディレクトリの作成

mkdir C:\PythonMCP
cd C:\PythonMCP

コードリポジトリのクローン

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

Pythonフォルダのコピー

copy unity-mcp-ollama\Python .

仮想環境の作成

python -m venv venv

仮想環境のアクティブ化

venv\Scripts\activate

依存関係のインストール

cd Python
pip install -e .

サーバーの起動

python server.py

💻 使用例

基本的な使用法

チャットインターフェイスのサンプルプロンプト

"位置(0, 1, 0)に赤色の立方体を作成する"
"シーンに球体を追加し、青色のマテリアルを適用する"
"現在のシーン内のすべてのオブジェクトをリストする"
"単純な移動スクリプトを作成し、立方体にアタッチする"

📚 ドキュメント

コンポーネントの状態説明

Pythonサーバーの状態：
- 緑色：接続済み
- 黄色：接続異常
- 赤色：未接続
Unityブリッジの状態：
- 実行中：Unityが接続要求を監視していることを示します
- 停止：Unityのソケットサーバーが実行されていないことを示します
Ollamaの状態：
- 接続済み：Ollamaサーバーに正常に接続されています
- 未接続：Ollamaに接続できません

性能に関する考慮事項

ローカルのLLMの性能はハードウェア構成に依存します。

deepseek-r1:14bモデルを使用する場合は、少なくとも12GBのVRAMを推奨します
gemma3:12bモデルを使用する場合は、少なくとも10GBのVRAMを推奨します
CPUのみのモードも可能ですが、速度は著しく低下します

トラブルシューティング

一般的な問題

Pythonサーバーが接続されていない
- Pythonサーバーが実行されていることを確認してください（python server.pyを実行）
- Pythonコンソールにエラーメッセージが表示されていないか確認してください
- Unityブリッジが起動されていることを確認してください
Unity MCPメニューが見つからない
- Editorスクリプトが正しくプロジェクトにインポートされていることを確認してください
- Unityコンソールにエラーメッセージが表示されていないか確認してください
- Unityを再起動して問題を解決してみてください
Ollamaの接続問題
- Ollamaサービスが実行されていることを確認してください（ollama serveで確認）
- モデルが正しく読み込まれていることを確認してください
- ファイアウォール設定を確認し、11434ポートがブロックされていないことを確認してください
MCPコマンドの実行に失敗する
- Pythonコンソールで詳細なエラーメッセージを確認してください
- Unityブリッジが正常に動作していることを確認してください
- プロンプト命令が明確であることを確認してください