Unity MCP Server

Unity MCP Server 让 Claude 能够与您的 Unity 项目进行交互！通过与 Claude 的自然对话，您可以创建脚本、管理着色器、组织文件夹等。

日语版 README 请点击这里 | 英文版

🎮 您可以做什么？

与 Claude 对话以实现以下功能：

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

🚀 快速开始（推荐：Claude 桌面扩展）

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

1. 下载扩展

   • 前往 最新发布
   • 下载 unity-mcp-server.dxt（42KB）

2. 在 Claude 桌面中安装

   • 打开 Claude 桌面
   • 进入扩展
   • 点击“从文件安装”
   • 选择已下载的 unity-mcp-server.dxt

3. 开始使用！

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

方案 2：手动安装（适用于开发者）

<details> <summary>点击查看手动安装步骤</summary>

1. 克隆并构建：

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

2. 配置 Claude 桌面：

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

</details>

📝 如何使用

一旦安装完成，只需与 Claude 自然对话：

创建脚本

您："创建一个处理伤害和治疗的 PlayerHealth 脚本"
Claude："我将为您创建一个 PlayerHealth 脚本..."

创建着色器

您："我需要一个带有波浪动画的水着色器"
Claude："我将为您创建一个带有波浪动画的水着色器..."

组织您的项目

您："为平台游戏设置文件夹结构"
Claude："我将为您创建一个有序的文件夹结构..."

检查项目信息

您："我在使用哪个 Unity 版本和渲染管线？"
Claude："让我检查一下您的项目信息..."

🎯 功能

• ✅ 智能脚本创建 - Claude 理解 Unity 模式，并创建正确的 MonoBehaviours
• ✅ 着色器支持 - 支持内置、URP 和 HDRP 渲染管线
• ✅ 项目组织 - 创建、移动和重命名文件夹，使项目整洁
• ✅ 自动设置 - 当需要时，Claude 自动设置 Unity 集成
• ✅ 安全操作 - 所有更改都通过适当的 Unity 资产处理安全地进行

🛠️ 故障排除

“Unity 服务器未响应”

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

“找不到我的项目”

• 告诉 Claude 确切路径：“我的 Unity 项目位于 C:/Projects/MyGame”
• 确保它是一个有效的 Unity 项目，包含一个 Assets 文件夹

需要帮助？

• 向 Claude 提问：“帮我解决 Unity MCP 的问题”
• 查看 问题列表
• 查看 技术文档 获取更多详细信息

🎮 Unity 版本支持

• Unity 2019.4+ - 完全支持
• Unity 6 (6000.0+) - 推荐最佳体验
• 支持 Windows、macOS 和 Linux

📈 最新更新（v3.1.1）

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

🤝 贡献

想帮助改进 Unity MCP Server？请参阅我们的 贡献指南！

📝 许可证

MIT 许可证 - 详见 LICENSE

🙏 致谢

• Anthropic 提供 Claude 和 MCP
• Unity Technologies 提供出色的引擎
• 所有贡献者和用户！

---

准备好用 Claude 加速您的 Unity 开发了吗？ 立即下载扩展！