Unitymcp VRC

🚀 關於VRChat世界構建倉庫

本倉庫從Arodoid/UnityMCP分叉而來，並進行了大量重構。主要用於測試使用Claude/MCP/Unity創建VRChat世界。由於Claude在編譯UdonSharp腳本時存在困難，此倉庫支持MCP資源和輔助腳本，有效提高了構建VRC世界的成功率。此外，它還包含許多對普通Unity開發有幫助的一般性改進，歡迎試用！

🚀 快速開始

1. 在unity-mcp-server目錄下構建MCP服務器：
   • 打開終端，導航到該目錄並運行構建命令。
2. 將UnityMCPPlugin文件夾複製到項目的Assets文件夾中，並在Unity中找到新的菜單選項：
   • 確保插件已正確導入並在項目設置中啟用。
3. 在Claude Desktop上啟用開發者模式，並添加以下MCP服務器設置：

   {
     "server": "http://localhost:XXXX"
   }
   

   其中XXXX是服務器實際運行的端口號。
4. 驗證連接狀態，運行提示詞，並使用資源附件功能：
   • 確保所有必要的端口和防火牆設置已正確配置以允許通信。

✨ 主要特性

命令執行

• 改進代碼執行方式，使大語言模型（LLM）能夠定義using、類和函數，允許LLM執行更復雜的命令，包括多個功能。
• 由於錯誤堆棧會消耗大量上下文信息，僅返回第一行通常就足夠。
• 增加對以下模塊的引用：
  • .Net Standard
  • System.Core、System.IO
  • TextMeshPro程序集
  • VRChat程序集
  • Unity Physics
  • 對MCPUnity本身的引用，以便為MCP命令提供輔助功能

Unity編輯器集成

• 增加在Unity未連接時等待/重試的功能。
• 將getEditorState改為按需運行。
• 實現了在獲取編輯器狀態和執行命令時等待編譯完成。
• 重新實現了GetAssets，以檢索所有位於Assets文件夾中的內容。

手動腳本測試

• 創建了一個腳本測試工具，用於診斷C#命令。
• 允許手動執行帶有詳細日誌的編輯器命令。

MCP資源

• 將任何添加到resources/text文件夾中的文件暴露為MCP資源。

性能

• 通過僅在檢測到更改時重繪來降低MCP窗口的高CPU使用率。
• 支持Unity中超過4KB的命令。
• 減少了重新連接過程中過多的調試日誌。

代碼重構

• 將Unity連接邏輯重構為獨立文件。
• 將MCP服務器工具分離到單獨文件中，並實現了通用接口以簡化新功能的添加。
• 將編輯器狀態報告和命令執行拆分為獨立文件。

VRChat特定功能

• 添加了一個輔助腳本，用於從C#文件生成UdonSharp資產文件。

📄 許可證

項目採用知識共享署名 - 非商業性使用4.0國際許可協議。