Unity Ollama

🚀 Unity MCP 與 Ollama 集成使用指南

本指南將詳細介紹如何在 Unity 中藉助 MCP 協議，通過 Ollama 集成本地大語言模型（LLMs）。利用此集成，你可以輕鬆實現創建場景對象、附加腳本等功能。文檔會全面涵蓋安裝步驟、配置說明、使用方法、狀態指示、性能考量、故障排除等內容。

🚀 快速開始

本指南將帶你完成在 Unity 中使用 MCP 協議通過 Ollama 集成本地大語言模型（LLMs）的過程。

✨ 主要特性

• 支持在 Unity 中通過 MCP 協議與 Ollama 集成，實現本地大語言模型的調用。
• 可以根據自然語言提示創建場景對象、附加腳本等。
• 提供狀態指示，方便了解各組件的連接狀態。

📦 安裝指南

系統要求

• 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 的 socket 服務器未運行

• Ollama 狀態：

  • 已連接：成功連接到 Ollama 服務器
  • 未連接：無法連接到 Ollama

性能考量

本地 LLM 性能依賴硬件配置：

• 使用deepseek - r1:14b模型推薦至少 12GB 顯存
• 使用gemma3:12b模型推薦至少 10GB 顯存
• CPU - only 模式可行但速度會顯著降低

故障排除

常見問題

1. Python 服務器未連接

   • 確保 Python 服務器正在運行（執行python server.py）
   • 檢查 Python 控制檯是否有錯誤信息
   • 確認 Unity 橋接已啟動

2. 找不到 Unity MCP 菜單

   • 確保 Editor 腳本已正確導入項目
   • 檢查 Unity 控制檯是否有錯誤提示
   • 重啟 Unity 嘗試解決

3. Ollama 連接問題

   • 確保 Ollama 服務正在運行（通過ollama serve檢查）
   • 核對模型是否已正確加載
   • 查看防火牆設置，確認 11434 端口未被阻止

4. MCP 命令執行失敗

   • 檢查 Python 控制檯獲取詳細錯誤信息
   • 確保 Unity 橋接正常運行
   • 確認提示指令清晰明確

📄 許可證

本項目遵循 MIT 許可證。

致謝

感謝以下項目的貢獻：

• 基於Justin P. Barnett 的 unity - mcp
• 使用Ollama實現本地 LLM 集成