🚀 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 中报告问题或提出改进建议