Unity MCP

🚀 Unity MCP 插件更新日誌

本插件主要用於優化 Unity 項目與 MCP 相關的功能，此次更新帶來了新特性，同時也存在一些已知問題，下面為你詳細介紹。

✨ 主要特性

• 通信協議更新：更新了 MCP 服務器與客戶端之間的通信協議，提升通信效率與穩定性。
• 自定義工具支持：增加了對自定義工具的支持，為開發者提供更多拓展性。
• 錯誤提示優化：提供了更多詳細的錯誤提示和調試信息，便於開發者快速定位和解決問題。
• 性能優化：優化了性能，特別是在處理大規模場景時的表現，提升了運行效率。

⚠️ 已知問題

1. 自定義工具支持受限：由於 csharp-sdk 中存在一些未解決的問題，目前無法完全支持自定義工具的開發。請關注以下兩個問題：

   • GitHub 討論
   • GitHub 問題

2. 多線程處理限制：某些工具可能需要在主線程外運行，但目前插件默認強制使用主線程以確保與 Unity API 的兼容性。

📥 下載地址

• GitHub 倉庫
• Releases 頁面

💻 使用示例

基礎用法

1. 項目路徑要求：

   • 確保 Unity 項目的路徑中不包含空格，例如：

     C:/MyProjects/Project
     

     而不是：

     C:/My Projects/Project
     

2. 打開 Unity 項目後，進入菜單欄的 Window -> AI Connector (Unity-MCP)。

   

3. 安裝 MCP 客戶端：

   • 推薦使用 Cursor
   • 或者 Claude

4. 在 MCP 客戶端中登錄您的賬戶。

5. 點擊 Configure 進行插件配置。

   

6. 重啟 MCP 客戶端。

7. 確保 AI Connector 狀態為 "Connected" 或 "Connecting..."。

8. 在您的 MCP 客戶端中測試插件功能，例如：

   • 使用默認工具分析場景
   • 驗證自定義工具的調用

📚 詳細文檔

自定義工具開發指南

工具類創建

創建一個繼承自 MCP_Tool 的新類，並在該類上添加 [McpTool] 屬性，指定工具名稱和描述。

[McpTool("CustomTool", "這是一個自定義工具")]
public class CustomTool : MCP_Tool
{
    // 工具邏輯實現
}

方法定義

使用 [McpCommand] 屬性標記可執行命令，並在方法上添加參數描述。

[McpCommand("ProcessScene", "處理當前場景")]
public void ProcessScene([McpParam("filePath", "輸入文件路徑")] string filePath)
{
    // 處理邏輯
}

參數描述

使用 [McpParam] 屬性為參數添加描述信息。

[McpParam("radius", "處理半徑")]
float radius = 1.0f;

🤝 貢獻指南

1. Fork Unity-MCP 倉庫
2. 提交 Pull Request 前，請確保代碼通過所有測試用例
3. 在 Issues 中報告問題或提出改進建議