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 客户端中测试插件功能，例如：

   • 使用默认工具分析场景
   • 验证自定义工具的调用

自定义工具开发指南

工具类创建

1. 创建一个继承自 MCP_Tool 的新类。
2. 在该类上添加 [McpTool] 属性，并指定工具名称和描述。

[McpTool("CustomTool", "这是一个自定义工具")]
public class CustomTool : MCP_Tool
{
    // 工具逻辑实现
}

方法定义

1. 使用 [McpCommand] 属性标记可执行命令。
2. 在方法上添加参数描述，例如：

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