MCP Unity Editor (Game Engine) - MCP服务，MCP服务器，MCP教程

基本能力

产品定位

MCP Unity 是一个专为 Unity 编辑器设计的 AI 交互服务，旨在通过 AI 代理增强 Unity 开发流程，提供自动化操作和智能辅助功能。

核心功能

1. IDE 集成：
2. 自动将 Unity 的 Library/PackedCache 文件夹添加到工作区，提升代码智能感知能力。

3. 支持 Unity 包的自动补全和类型信息。

4. MCP 服务器工具：

5. execute_menu_item：执行 Unity 菜单项功能。
6. select_gameobject：通过路径或实例 ID 选择游戏对象。
7. update_component：更新或添加组件到游戏对象。
8. add_package：通过 Unity 包管理器安装新包。
9. run_tests：运行 Unity 测试。
10. notify_message：在 Unity 编辑器中显示消息。

11. add_asset_to_scene：将资源从 AssetDatabase 添加到场景。

12. MCP 服务器资源：

13. 提供 Unity 菜单项、场景层次结构、游戏对象详细信息、日志、包管理、资源和测试信息的访问接口。

适用场景

• Unity 开发自动化
• AI 辅助游戏开发
• 测试自动化
• 资源管理和场景构建

使用教程

使用依赖

1. Unity 2022.3 或更高版本
2. Node.js 18 或更高版本
3. npm 9 或更高版本

安装教程

1. 安装 Unity MCP Server 包：
2. 打开 Unity 包管理器（Window > Package Manager）
3. 点击 "+" 按钮，选择 "Add package from git URL..."
4. 输入：https://github.com/CoderGamester/mcp-unity.git

5. 点击 "Add"

6. 安装 Node.js：

7. Windows：下载并运行 Node.js LTS 版本的 Windows Installer (.msi)
8. macOS：下载并运行 Node.js LTS 版本的 macOS Installer (.pkg) 或使用 Homebrew：brew install node@18

9. 验证安装：node --version

10. 配置 AI LLM 客户端：

11. 通过 Unity 编辑器（Tools > MCP Unity > Server Window）配置
12. 或手动编辑 AI 客户端的 MCP 配置文件

调试方式

1. 启动服务器：
2. 打开 Unity 编辑器
3. 导航到 Tools > MCP Unity > Server Window

4. 点击 "Start Server"

5. 调试服务器：

6. 使用 MCP Inspector 调试：
   powershell
$env:UNITY_PORT=8090; npx @modelcontextprotocol/inspector node Server/build/index.js

7. 启用日志记录：
   powershell
$env:LOGGING = "true"
$env:LOGGING_FILE = "true"

8. 常见问题：

9. 连接问题：检查 WebSocket 服务器是否运行，防火墙设置，端口号是否正确
10. 服务器启动问题：检查 Unity 控制台错误，Node.js 安装和 PATH 设置
11. 菜单项执行问题：检查菜单项路径是否正确，是否需要确认，是否在当前上下文中可用