安装与设置

要求

• Unity 6000.0+（Unity 6）
• Newtonsoft JSON（com.unity.nuget.newtonsoft-json）—— 作为依赖自动安装
• git 必须安装并在 PATH 中可用 —— git-scm.com

安装

通过 Unity Asset Store（推荐）

直接从 Unity Asset Store 安装：

realvirtual MCP Server on Unity Asset Store

通过 Unity Package Manager（Git URL）

1. 打开 Unity Window > Package Manager
2. 点击 + > Add package from git URL
3. 输入：https://github.com/game4automation/io.realvirtual.mcp.git

两种方法都会自动安装包及其所有依赖。

设置

自动设置（推荐）

安装包后：

1. 一个 大脑图标 出现在 Unity Scene View 工具栏中 —— 这是 MCP状态指示器
2. 点击旁边的 齿轮图标 打开设置弹窗
3. 点击 Download Python Server —— 这会运行 git clone 将 Python 服务器下载到 Assets/StreamingAssets/realvirtual-MCP/
4. 点击 Configure Claude Code & Desktop —— 这会向 Claude Desktop 和/或 Claude Code 写入 MCP配置

配置完成后，弹窗显示绿色状态指示器：

您也可以通过 Unity菜单访问设置：Tools > realvirtual > MCP

手动设置

如果您更喜欢手动设置：

1. 克隆 Python 服务器仓库：

   cd <your-project>/Assets/StreamingAssets
   git clone https://github.com/game4automation/realvirtual-MCP.git

1. 手动配置您的 MCP客户端。对于 Claude Code，添加到您的 MCP设置：

   {
     "mcpServers": {
       "realvirtual-unity": {
         "command": "<project-path>/Assets/StreamingAssets/realvirtual-MCP/python/python.exe",
         "args": ["<project-path>/Assets/StreamingAssets/realvirtual-MCP/unity_mcp_server.py"]
       }
     }
   }

更新

Python 服务器

在工具栏弹窗中点击 Update Python Server (git pull)，或手动运行：

cd <your-project>/Assets/StreamingAssets/realvirtual-MCP
git pull

Unity包

1. 打开 Window > Package Manager
2. 选择 realvirtual MCP Server
3. 点击 Update（如果可用）

如果没有更新按钮出现，从 Packages/packages-lock.json 中删除 io.realvirtual.mcp 的锁条目，然后重新打开 Unity。