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国际许可协议。