Unity MCP Package
2025.04.06
1
C#Unity扩展材质编辑自动化工具开发效率
reavorse-mcp是一个Unity包，专注于增强材质编辑功能，基于原始的MCP功能进行扩展。目前仅实现了材质增强功能，但项目正在积极开发中，未来将增加光照效果、高级材质属性、物理集成、地形增强等功能。该包通过Model Context Protocol (MCP)实现Unity与大型语言模型(LLMs)之间的无缝通信，作为桥梁允许Unity发送命令并接收来自MCP兼容工具的响应。
View on GitHub
Overview
基本能力
产品定位
reavorse-mcp是一个Unity扩展包，旨在通过MCP协议实现Unity与LLMs之间的双向通信，增强Unity项目的开发效率和自动化能力。
核心功能
- 双向通信：在Unity和LLMs之间无缝发送和接收数据。
- 资产管理：程序化导入资产、实例化预制件和创建新预制件。
- 场景控制：打开、保存和修改场景，创建和操作游戏对象。
- 增强材质编辑和光照：改进材质属性控制、高级光照、着色器集成和后处理效果。
- 脚本集成：在Unity内创建、查看和更新C#脚本。
- 编辑器自动化：自动化Unity编辑器任务，如构建项目或进入播放模式。
- 实验性功能：正在测试的其他Unity功能。
适用场景
- 开发者希望通过LLMs增强Unity项目或自动化重复任务。
- 需要程序化控制Unity资产、场景和材质的项目。
- 需要与LLMs进行交互以增强开发流程的项目。
工具列表
- uv包管理器：简化Python依赖管理。
- Unity MCP包：提供与LLMs通信的功能。
常见问题解答
- Unity Bridge未运行：确保Unity编辑器已打开且MCP窗口处于活动状态。
- Python服务器未连接：验证Python和uv是否正确安装，Unity MCP包是否设置正确。
- Claude Desktop或Cursor配置问题：确保MCP客户端配置为与Unity MCP服务器通信。
- 连接卡住或无进展：关闭Claude和Unity项目，然后重新连接以重新建立连接。
使用教程
使用依赖
- Unity 2020.3 LTS或更新版本（目前仅适用于URP项目）
- Python 3.12或更新版本
- uv包管理器
安装教程
- 安装Python：从python.org下载并安装Python 3.12或更新版本，确保在安装过程中将Python添加到系统PATH。
- 安装uv：
- Mac：
brew install uv - Windows：
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"，然后set Path=%USERPROFILE%\.local\bin;%Path% - Linux：
curl -LsSf https://astral.sh/uv/install.sh | sh - 安装Unity包：
- 打开Unity，转到
Window > Package Manager。 - 点击
+按钮，选择Add package from git URL。 - 输入：
https://github.com/HuangChILun/reavorse-mcp.git
调试方式
- 确保Unity编辑器已打开且MCP窗口处于活动状态。
- 验证Python和uv是否正确安装。
- 检查MCP客户端配置是否正确。