Unity MCP 软件包

一个专注于增强材质编辑的 Unity 软件包，构建于原始 MCP 功能之上。目前，仅实现了材质增强，但该项目正在积极开发中，并会频繁更新。即将推出的功能包括光照效果、高级材质属性、物理集成、地形增强等。该软件包通过模型上下文协议 (MCP) 实现 Unity 和大型语言模型 (LLM) 之间的无缝通信，充当桥梁，允许 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 包管理器

步骤 1：安装 Python

从 python.org 下载并安装 Python 3.12 或更高版本。 确保在安装过程中将 Python 添加到系统的 PATH 中。

步骤 2：安装 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 之前，请勿继续。

步骤 3：安装 Unity 软件包

1. 打开 Unity 并转到 Window > Package Manager。
2. 单击 + 按钮并选择 Add package from git URL。
3. 输入：https://github.com/HuangChILun/reavorse-mcp.git

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

功能

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

故障排除

遇到问题？ 尝试以下修复方法：

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

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

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

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

联系方式

对项目有疑问？ 请联系！

• X: @reavorse

致谢

原始作者：非常感谢 justinpbarnett 创建了原始 Unity MCP 软件包。 这个增强版本建立在他的工作之上。

特别感谢 Unity Technologies 提供的出色编辑器 API 以及社区提供的持续反馈。