Reavorse MCP

🚀 Unity MCP 包

Unity MCP 包專注於增強材料編輯功能，基於原始 MCP 功能構建。目前僅實現了材料增強功能，但項目正在積極開發並會定期更新。後續將推出光照效果、高級材料屬性、物理集成、地形增強等特性。此包還充當 Unity 和大型語言模型 (LLMs) 之間的橋樑，通過 Model Context Protocol (MCP) 實現 Unity 與 MCP 兼容工具間的命令發送和響應接收，為開發者帶來更多便利。

🚀 快速開始

Unity MCP 包為開發者提供了強大的功能，能增強材料編輯等操作。使用前需完成安裝步驟，安裝完成後即可開啟高效開發之旅。

✨ 主要特性

雙向通信

在 Unity 和 Python 之間實現高效的命令發送和響應接收。

資產管理

輕鬆管理 Unity 資產，提升開發效率。

場景控制

對場景對象進行精細控制，優化編輯流程。

增強的材料編輯

通過改進的光照和著色器支持，實現更高質量的材料效果。

腳本集成

無縫集成 C# 腳本，擴展 Unity 功能。

編輯自動化

自動化常見編輯任務，提高開發效率。

其他功能

利用新的實驗性功能，探索更多可能性。

📦 安裝指南

要使用 Unity MCP 包，請確保安裝了以下內容：

• Unity 2020.3 LTS 或更高版本（⚠️ 當前僅在 URP 項目中工作）
• Python 3.12 或更高版本
• uv 包管理器

步驟 1：安裝 Python

從 python.org 下載並安裝 Python 3.12 或更高版本。安裝時請確保將 Python 添加到系統 PATH 中。

步驟 2：安裝 uv

uv 是一個簡化依賴管理的 Python 包管理器。根據你的操作系統使用以下命令進行安裝：

• Mac:

brew install uv

• Windows:

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

然後，將 uv 添加到 PATH 中：

set Path=%USERPROFILE%\.local\bin;%Path%

• Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

有關其他安裝方法，請參閱 uv 安裝指南。

注意：未安裝 uv 則無法繼續。

步驟 3：安裝 Unity 包

1. 打開 Unity 並轉到 Window > Package Manager。
2. 點擊 + 按鈕，選擇 從 Git URL 添加包。
3. 輸入: https://github.com/HuangChILun/reavorse-mcp.git

安裝完成後，Unity MCP 包將在你的 Unity 項目中可用。使用 Claude Desktop 或 Cursor 等 MCP 客戶端時，服務器會自動啟動。

📚 詳細文檔

概覽

Unity MCP 服務器提供了一個雙向通信通道，使 Unity（通過 C#）與 Python 服務器之間能夠：

• 資產管理：創建、導入和操作 Unity 資產。
• 場景控制：管理場景、對象及其屬性。
• 增強的材料編輯：應用並修改具有改進光照和著色器支持的材料。
• 腳本集成：創建、查看和更新 Unity 中的 C# 腳本。
• 編輯自動化：控制 Unity 編輯器功能，例如撤消、重做、播放模式和構建過程。
• 其他 Unity 功能：利用新的實驗性功能，例如高級光照控制和後處理效果。

此項目非常適合希望利用 LLM 增強其 Unity 項目或自動化重複性任務的開發人員。

故障排除

問題 1: Unity Bridge 沒有運行

確保 Unity 編輯器已啟動，並且 MCP 服務器正在運行。如果需要幫助，請參考 官方文檔。

問題 2: 安裝 Python 出錯

檢查你的操作系統是否支持 Python 的最低版本要求（3.12 或更高）。如果仍然有問題，可以聯繫 Python 社區尋求幫助。

問題 3: uv 工具未安裝

按照上述步驟重新安裝 uv 工具，並確保其路徑配置正確。如果問題持續，請訪問 uv 官網 查找更多信息。

📄 許可證

文檔中未提及許可證相關信息，故跳過該章節。

🔗 聯繫與鳴謝

聯繫

如需聯繫開發者或獲取支持，請訪問 GitHub 倉庫 或通過電子郵件與我們聯繫：contact@unitymcp.com。

鳴謝

感謝以下人員和項目的貢獻：

• 原始 MCP 協議的作者。
• Unity 社區的支持和反饋。
• 所有為改進此項目做出貢獻的開發人員。