Unity MCP 包

这是一个专注于增强材质编辑的 Unity 包，基于原始的 MCP 功能构建。目前仅实现了材质增强功能，但该项目正在积极开发中，并且会频繁更新。即将推出的功能包括光照效果、高级材质属性、物理集成、地形增强等。此包通过模型上下文协议（MCP）实现 Unity 和大型语言模型（LLMs）之间的无缝通信，充当一个桥梁，使 Unity 能够向符合 MCP 规范的工具发送命令并接收响应。

概览

Unity MCP 服务器提供了一个双向通信通道，连接 Unity（通过 C#）和一个 Python 服务器，支持以下功能：

• 资产管理：程序化地创建、导入和操作 Unity 资产。
• 场景控制：管理场景、对象及其属性。
• 增强材质编辑：应用和修改具有改进光照和着色器支持的材质。
• 脚本集成：在 Unity 中创建、查看和更新 C# 脚本。
• 编辑器自动化：控制 Unity 编辑器功能，如撤销、重做、播放模式和构建过程。
• 其他 Unity 功能：利用新的实验性功能，例如高级光照控制和后期处理效果。

这个项目非常适合希望利用 LLM 来增强他们的 Unity 项目或自动化重复任务的开发者。

安装

要使用 Unity MCP 包，请确保安装了以下内容：

• Unity 2020.3 LTS 或更高版本（⚠️ 目前仅适用于 URP 项目）
• Python 3.12 或更高版本
• uv 包管理器

第一步：安装 Python

从 python.org 下载并安装 Python 3.12 或更高版本。安装时请确保将 Python 添加到系统路径中。

第二步：安装 uv

uv 是一个简化依赖管理的 Python 包管理器。根据您的操作系统，使用以下命令进行安装：

• Mac：

  brew install uv
  

• Windows：

  powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
  

  然后，将 uv 添加到您的 PATH 中：

  set Path=%USERPROFILE%\.local\bin;%Path%
  

• Linux：

  curl -LsSf https://astral.sh/uv/install.sh | sh
  

有关其他安装方法，请参阅 uv 安装指南。

重要：未安装 uv 不得继续。

第三步：安装 Unity 包

1. 打开 Unity 并转到 窗口 > 包管理器。
2. 点击 + 按钮并选择 从 Git URL 添加包。
3. 输入：https://github.com/HuangChILun/reavorse-mcp.git

安装完成后，Unity MCP 包将在您的 Unity 项目中可用。当与像 Claude Desktop 或 Cursor 这样的 MCP 客户端一起使用时，服务器将自动启动。

特性

• 双向通信：在 Unity 和 LLM 之间无缝发送和接收数据。
• 资产管理：导入资产、实例化预制件并程序化地创建新预制件。
• 场景控制：打开、保存和修改场景，以及创建和操作游戏对象。
• 增强材质编辑及光照：改进材质属性控制、高级光照、着色器集成和后期处理效果。
• 脚本集成：在 Unity 中创建、查看和更新 C# 脚本。
• 编辑器自动化：自动化 Unity 编辑器任务，如构建项目或进入播放模式。
• 实验性功能：其他 Unity 功能正在测试中；欢迎反馈。

故障排除

遇到问题？尝试以下解决办法：

• Unity 桥未运行
  确保 Unity 编辑器已打开且 MCP 窗口处于活动状态。如有必要，请重新启动 Unity。

• Python 服务器未连接
  验证 Python 和 uv 是否正确安装，以及 Unity MCP 包是否设置正确。

• Claude Desktop 或 Cursor 配置问题
  确保您的 MCP 客户端配置为与 Unity MCP 服务器通信。

• 连接卡住或无进展 在某些特殊情况下，如果进程似乎卡住且没有进展，请尝试关闭 Claude 和 Unity 项目，然后重新连接以重新建立连接。

联系方式

有关项目的问题？请联系！

• X：@reavorse

致谢

原作者：非常感谢 justinpbarnett 创建了原始的 Unity MCP 包。此增强版在此基础上进行了扩展。

特别感谢 Unity Technologies 提供的优秀编辑器 API 和社区提供的持续反馈。