Unity Ollama

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

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

スコア : 2.5ポイント

ダウンロード数 : 23

更新時間 : 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ブリッジが正常に動作していることを確認してください
- プロンプト命令が明確であることを確認してください