MCP Unity

MCP Unity 是一个基于 Model Context Protocol（MCP）的 Unity 编辑器扩展，旨在通过 AI 助手与 Unity 项目进行交互，实现 Unity 与 Node.js 服务器之间的通信。该工具允许开发者通过自然语言指令执行 Unity 编辑器中的操作，如创建游戏对象、添加组件、运行测试等，从而显著提升开发效率。

核心功能

MCP Unity 提供了多种核心功能，使开发者能够通过 AI 助手自动化 Unity 编辑器中的常见任务。这些功能包括：

• 执行菜单项：通过 AI 助手执行 Unity 编辑器中的菜单项操作。
• 选择游戏对象：根据路径或实例 ID 选择场景中的游戏对象。
• 更新组件：为游戏对象添加或更新组件属性。
• 添加包：通过 AI 助手向 Unity 项目中添加新的包。
• 运行测试：使用 Unity 测试运行器运行测试。
• 通知消息：向 Unity 编辑器发送通知消息。
• 添加资产到场景：从资源数据库中添加资产到当前场景。

安装方法

安装 MCP Unity 需要通过 Unity Package Manager 安装插件，并配置 Node.js 环境。以下是详细步骤：

1. 通过 Unity Package Manager 安装 MCP Unity 插件。
2. 确保已安装 Node.js 18 或更高版本。
3. 在 Unity 编辑器中配置 AI 助手的连接设置。
4. 在 Unity 编辑器中启动 MCP 服务器。

cd 绝对路径/To/mcp-unity/Server
npm install
npm run build

使用方法

MCP Unity 的使用流程包括配置、启动服务器和执行命令。以下是基本使用步骤：

1. 在 Unity 编辑器中进入 Edit > Project Settings。
2. 选择 MCP Settings 标签。
3. 在 Server Location 中指定 MCP 服务器路径。
4. 点击 Apply 保存设置。
5. 在 Unity 编辑器中启动服务器，路径为 Tools > MCP Unity > Start Server。

使用示例

以下是几个 MCP Unity 的使用示例，展示其在实际开发中的应用：

• 添加空的游戏对象：通过 AI 助手创建一个空的游戏对象。
• 安装 TextMeshPro 包：通过 AI 助手安装 TextMeshPro 包。
• 运行编辑模式测试：通过 AI 助手运行编辑模式下的所有测试。

Tools > MCP Unity > Start Server

配置说明

MCP Unity 的配置主要集中在 Unity 编辑器中，开发者需要进行以下配置：

• 在 Edit > Project Settings 中选择 MCP Settings。
• 设置 Server Location 为 MCP 服务器路径。
• 配置 AI 助手的连接设置，路径为 tools/mcp-unity/config.json。

使用场景

MCP Unity 适用于需要自动化 Unity 开发流程的开发者，例如：

• 生成代码
• 测试脚本
• 添加资源
• 执行编辑器命令

注意事项

在使用 MCP Unity 时，需要注意以下事项：

• 确保 Unity 版本为 2022.3 或更高。
• Node.js 版本需为 18 或更高。
• 服务器需保持运行状态，且端口配置正确。
• 防火墙设置需允许服务器通信。

调试与日志

MCP Unity 提供了调试支持和日志记录功能，开发者可以通过以下方式查看日志：

• 在 Unity 编辑器中启用调试模式。
• 使用浏览器访问 localhost:8080 查看调试信息。
• 通过设置环境变量 DEBUG=* 启用详细日志。

常见问题

以下是 MCP Unity 的常见问题及解决方法：

• 连接问题：确保服务器正在运行，检查端口是否正确配置。
• 服务启动失败：检查 Unity 控制台中的错误信息，确保 Node.js 已正确安装。
• 查看 Unity 日志：通过 Unity 编辑器中的日志窗口查看。

MCP Unity 通过将 AI 助手与 Unity 编辑器集成，为开发者提供了一种全新的自动化开发方式，极大提升了开发效率和灵活性。