MCP Server Unity

Unity MCP服务器

Unity MCP服务器允许Claude处理您的Unity项目！创建脚本、管理着色器、组织文件夹——所有这些都是通过与克劳德的自然对话完成的。

日语版README 在这里 | 英语

🎮 你能做什么？

与克劳德交谈：

• 创建Unity脚本：“创建具有跳转功能的PlayerController脚本”
• 管理着色器：“为我的角色创建一个卡通着色器”
• 组织项目：“为我的RPG游戏创建文件夹结构”
• 获取项目信息：“我的项目使用什么渲染管道？”

🚀 快速入门（推荐：Claude桌面扩展）

选项1：通过Claude桌面扩展安装（最简单）

1. 下载扩展

- 首选 最新版本 - 下载 unity-mcp-server.dxt （42KB）

1. 在Claude桌面中安装

- 打开克劳德桌面 - 转到扩展 - 点击“从文件安装” - 选择已下载的 unity-mcp-server.dxt

1. 开始使用！

- 打开任何Unity项目（2019.4或更新版本） - 在Unity中安装Newtonsoft JSON包： - 开窗→ 程序包管理器 - 点击“+”按钮，选择“按名称添加包…” - 输入： com.unity.nuget.newtonsoft-json - 点击“添加” - 问Claude：“在我的项目/path/to/project中设置Unity MCP” - 克劳德将自动安装所有内容！

选项2：手动安装（适用于开发人员）

Click to see manual installation steps

1. 克隆和构建：

   git clone https://github.com/zabaglione/mcp-server-unity.git
   cd mcp-server-unity
   npm install
   npm run build

1. 配置Claude桌面：

   {
     "mcpServers": {
       "unity": {
         "command": "node",
         "args": ["/path/to/mcp-server-unity/build/simple-index.js"]
       }
     }
   }

📝 如何使用

安装后，只需自然地与Claude交谈：

创建脚本

You: "Create a PlayerHealth script that handles damage and healing"
Claude: I'll create a PlayerHealth script for you...

创建着色器

You: "I need a water shader with wave animation"
Claude: I'll create a water shader with wave animation...

组织您的项目

You: "Set up a folder structure for a platformer game"
Claude: I'll create an organized folder structure for your platformer...

检查项目信息

You: "What Unity version and render pipeline am I using?"
Claude: Let me check your project information...

🎯 特性

• ✅ 智能脚本创建 -克劳德理解统一模式，并创造了适当的单一行为
• ✅ 遮阳板支撑 -使用内置、URP和HDRP渲染管道
• ✅ 项目组织机构 -创建、移动和重命名文件夹以保持项目整洁
• ✅ 自动设置 -需要时，Claude会自动设置Unity集成
• ✅ 安全操作 -所有更改都是通过适当的Unity资产处理安全进行的

🛠️ 故障排除

“Unity服务器没有响应”

1. 确保Unity编辑器已打开
2. 检查窗口→ Unity中的Unity MCP服务器
3. 如果服务器未运行，请单击“启动服务器”

“找不到我的项目”

• 告诉克劳德确切的路径：“我的Unity项目位于C:/Projects/MyTame”
• 确保它是一个带有Assets文件夹的有效Unity项目

需要帮助？

• 问克劳德：“帮我排除Unity MCP的故障”
• 检查 问题
• 看 技术文档 有关高级详细信息

🎮 Unity版本支持

• Unity 2019.4+ -全力支持
• Unity 6（6000.0+） -推荐最佳体验
• 适用于Windows、macOS和Linux

📈 最新更新（v3.1.1）

• ✅ 修复了渲染管道检测（现在可以正确识别内置、URP、HDRP）
• ✅ 已解决AssetDatabase同步错误
• ✅ 改进了文件管理和Unity集成稳定性

🤝 贡献

想帮助改进Unity MCP服务器吗？查看我们的 贡献指南!

📝 许可证

MIT许可证-请参阅 许可证

🙏 致谢

• Anthropic 克劳德和MCP
• Unity技术 对于令人惊叹的游戏引擎
• 我们所有的贡献者和用户！

______________________________________________________________________

准备好与Claude一起加速Unity开发了吗？ 立即下载扩展！