星战科技xingzhan.cloud
返回市场
麦克佩奇统一

麦克佩奇统一

作者：CoderGamester1102 星标更新：2025-11-04
安装使用来源：spider==github.com

项目介绍

MCP Unity 编辑器（游戏引擎）

信任评分

🇺🇸英语🇨🇳简体中文🇯🇵日语
                              ,/(/.   *(/,                                  
                          */(((((/.   *((((((*.                             
                     .*((((((((((/.   *((((((((((/.                         
                 ./((((((((((((((/    *((((((((((((((/,                     
             ,/(((((((((((((/*.           */(((((((((((((/*.                
            ,%%#((/((((((*                    ,/(((((/(#&@@(                
            ,%%##%%##((((((/*.             ,/((((/(#&@@@@@@(                
            ,%%######%%##((/(((/*.    .*/(((//(%@@@@@@@@@@@(                
            ,%%####%#(%%#%%##((/((((((((//#&@@@@@@&@@@@@@@@(                
            ,%%####%(    /#%#%%%##(//(#@@@@@@@%,   #@@@@@@@(                
            ,%%####%(        *#%###%@@@@@@(        #@@@@@@@(                
            ,%%####%(           #%#%@@@@,          #@@@@@@@(                
            ,%%##%%%(           #%#%@@@@,          #@@@@@@@(                
            ,%%%#*              #%#%@@@@,             *%@@@(                
            .,      ,/##*.      #%#%@@@@,     ./&@#*      *`                
                ,/#%#####%%#/,  #%#%@@@@, ,/&@@@@@@@@@&\.                    
                 `*#########%%%%###%@@@@@@@@@@@@@@@@@@&*´                   
                    `*%%###########%@@@@@@@@@@@@@@&*´                        
                        `*%%%######%@@@@@@@@@@&*´                            
                            `*#%%##%@@@@@&*´                                 
                               `*%#%@&*´                                     
                                                       
     ███╗   ███╗ ██████╗██████╗         ██╗   ██╗███╗   ██╗██╗████████╗██╗   ██╗
     ████╗ ████║██╔════╝██╔══██╗        ██║   ██║████╗  ██║██║╚══██╔══╝╚██╗ ██╔╝
     ██╔████╔██║██║     ██████╔╝        ██║   ██║██╔██╗ ██║██║   ██║    ╚████╔╝ 
     ██║╚██╔╝██║██║     ██╔═══╝         ██║   ██║██║╚██╗██║██║   ██║     ╚██╔╝  
     ██║ ╚═╝ ██║╚██████╗██║             ╚██████╔╝██║ ╚████║██║   ██║      ██║   
     ╚═╝     ╚═╝ ╚═════╝╚═╝              ╚═════╝ ╚═╝  ╚═══╝╚═╝   ╚═╝      ╚═╝

MCP Unity 是一个为 Unity 编辑器实现的 Model Context Protocol，允许 AI 助手与您的 Unity 项目进行交互。此包提供了一个连接 Unity 和实现 MCP 协议的 Node.js 服务器之间的桥梁，使像 Claude、Windsurf 和 Cursor 这样的 AI 代理能够在 Unity 编辑器中执行操作。

<a href="https://glama.ai/mcp/servers/@CoderGamester/mcp-unity"> <img width="400" height="200" src="https://gips0.baidu.com/it/u=1616337775,566444808&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Unity MCP 服务器" /> </a>

特性

IDE 集成 - 包缓存访问

MCP Unity 提供了与类似 Visual Studio Code 的 IDE（如 Visual Studio Code、Cursor、Windsurf）的自动集成，通过将 Unity 的 Library/PackedCache 文件夹添加到工作区来实现。该功能：

  • 改善了 Unity 包的代码智能
  • 提高了 Unity 包的自动完成功能和类型信息
  • 帮助 AI 编码助手理解项目的依赖关系

MCP 服务器工具

以下工具可用于通过 MCP 操作和查询 Unity 场景和 GameObject：

  • execute_menu_item：执行 Unity 菜单项（标记有 MenuItem 属性的函数）

    示例提示："执行菜单项 'GameObject/Create Empty' 创建一个新的空 GameObject"

  • select_gameobject：通过路径或实例 ID 在 Unity 层次结构中选择游戏对象

    示例提示："在我的场景中选择 Main Camera 对象"

  • update_gameobject：更新 GameObject 的核心属性（名称、标签、层、活动/静态状态），如果不存在则创建 GameObject

    示例提示："将 Player 对象的标签设置为 'Enemy' 并使其不活动"

  • update_component：更新 GameObject 上的组件字段，如果 GameObject 不包含该组件，则将其添加到 GameObject 中

    示例提示："向 Player 对象添加一个 Rigidbody 组件，并将其质量设置为 5"

  • add_package：在 Unity 包管理器中安装新包

    示例提示："将 TextMeshPro 包添加到我的项目中"

  • run_tests：使用 Unity 测试运行器运行测试

    示例提示："运行我项目中的所有 EditMode 测试"

  • send_console_log：发送控制台日志到 Unity

    示例提示："发送一条控制台日志到 Unity 编辑器"

  • add_asset_to_scene：从 AssetDatabase 将资产添加到 Unity 场景中

    示例提示："将我项目中的 Player prefab 添加到当前场景"

  • create_prefab：创建一个带有可选 MonoBehaviour 脚本和序列化字段值的预制件

    示例提示："从 'PlayerController' 脚本创建一个名为 'Player' 的预制件"

  • recompile_scripts：重新编译 Unity 项目中的所有脚本

    示例提示："重新编译我 Unity 项目中的脚本"

MCP 服务器资源

  • unity://menu-items：检索 Unity 编辑器中所有可用的菜单项列表，以支持 execute_menu_item 工具

    示例提示："显示所有与 GameObject 创建相关的可用菜单项"

  • unity://scenes-hierarchy：检索当前 Unity 场景层次结构中的所有游戏对象列表

    示例提示："显示当前场景层次结构结构"

  • unity://gameobject/{id}：通过实例 ID 或场景层次结构中的对象路径检索特定 GameObject 的详细信息，包括所有 GameObject 组件及其序列化属性和字段

    示例提示："获取关于 Player GameObject 的详细信息"

  • unity://logs：检索 Unity 控制台中的所有日志列表

    示例提示："显示最近来自 Unity 控制台的错误消息"

  • unity://packages：检索已安装和可用包的信息，这些信息来自 Unity 包管理器

    示例提示："列出我 Unity 项目中当前安装的所有包"

  • unity://assets：检索 Unity 资产数据库中的资产信息

    示例提示："查找我项目中的所有纹理资产"

  • unity://tests/{testMode}：检索 Unity 测试运行器中的测试信息

    示例提示："列出我 Unity 项目中所有可用的测试"

要求

[!IMPORTANT] 项目路径不能包含空格

重要的是，您的 Unity 项目的文件路径不能包含任何空格。 如果您的项目路径包含空格，MCP 客户端（例如 Cursor、Claude、Windsurf）将无法连接到 MCP Unity 服务器。

示例：

  • ✅ 有效：C:\Users\YourUser\Documents\UnityProjects\MyAwesomeGame
  • ❌ 无效：C:\Users\Your User\Documents\Unity Projects\My Awesome Game

请确保您的项目位于没有空格的路径下，然后再继续安装。

<a name="install-server"></a>安装

安装这个 MCP Unity 服务器是一个多步骤的过程：

步骤 1：安装 Node.js

要运行 MCP Unity 服务器，您需要在计算机上安装 Node.js 18 或更高版本：

node

<details> <summary><span style="font-size: 1.1em; font-weight: bold;">Windows</span></summary>
  1. 访问 Node.js 下载页面
  2. 下载 LTS 版本的 Windows 安装程序（.msi）（推荐）
  3. 运行安装程序并按照安装向导进行操作
  4. 通过打开 PowerShell 并运行以下命令来验证安装： 
    node --version
</details> <details> <summary><span style="font-size: 1.1em; font-weight: bold;">macOS</span></summary>
  1. 访问 Node.js 下载页面
  2. 下载 LTS 版本的 macOS 安装程序（.pkg）（推荐）
  3. 运行安装程序并按照安装向导进行操作
  4. 如果您已经安装了 Homebrew，您可以运行： 
    brew install node@18
  5. 通过打开终端并运行以下命令来验证安装： 
    node --version
</details>

步骤 2：通过 Unity 包管理器安装 Unity MCP 服务器包

  1. 打开 Unity 包管理器（窗口 > 包管理器）
  2. 点击左上角的“+”按钮
  3. 选择“从 Git URL 添加包...”
  4. 输入：https://github.com/CoderGamester/mcp-unity.git
  5. 点击“添加”

包管理器

步骤 3：配置 AI LLM 客户端

<details open> <summary><span style="font-size: 1.1em; font-weight: bold;">选项 1：使用 Unity 编辑器配置</span></summary>
  1. 打开 Unity 编辑器
  2. 导航到工具 > MCP Unity > 服务器窗口
  3. 如下图所示，点击您 AI LLM 客户端的“配置”按钮

图像

  1. 使用弹出窗口确认配置安装

图像

</details> <details> <summary><span style="font-size: 1.1em; font-weight: bold;">选项 2：手动配置</span></summary>

打开您的 AI 客户端的 MCP 配置文件（例如 Claude Desktop 中的 claude_desktop_config.json），并复制以下文本：

将 ABSOLUTE/PATH/TO 替换为您 MCP Unity 安装的绝对路径，或者直接从 Unity 编辑器 MCP 服务器窗口（工具 > MCP Unity > 服务器窗口）复制文本。

{
   "mcpServers": {
       "mcp-unity": {
          "command": "node",
          "args": [
             "ABSOLUTE/PATH/TO/mcp-unity/Server~/build/index.js"
          ]
       }
   }
}
</details>

<a name="start-server"></a>启动 Unity 编辑器 MCP 服务器

  1. 打开 Unity 编辑器
  2. 导航到工具 > MCP Unity > 服务器窗口
  3. 点击“启动服务器”以启动 WebSocket 服务器
  4. 打开 Claude Desktop 或您的 AI 编码 IDE（例如 Cursor IDE、Windsurf IDE 等），并开始执行 Unity 工具

连接

当 AI 客户端连接到 WebSocket 服务器时，它会自动显示在窗口中的绿色框内

可选：设置 WebSocket 端口

默认情况下，WebSocket 服务器运行在端口 '8090'。您可以按以下两种方式更改此端口：

  1. 打开 Unity 编辑器
  2. 导航到工具 > MCP Unity > 服务器窗口
  3. 将“WebSocket 端口”值更改为所需的端口号
  4. Unity 将设置系统环境变量 UNITY_PORT 为新的端口号
  5. 重启 Node.js 服务器
  6. 再次点击“启动服务器”，以重新连接 Unity 编辑器的 WebSocket 到 Node.js MCP 服务器

可选：设置超时时间

默认情况下，MCP 服务器和 WebSocket 之间的超时时间为 10 秒。 您可以根据所使用的操作系统进行更改：

  1. 打开 Unity 编辑器
  2. 导航到工具 > MCP Unity > 服务器窗口
  3. 将“请求超时（秒）”值更改为所需的超时秒数
  4. Unity 将设置系统环境变量 UNITY_REQUEST_TIMEOUT 为新的超时值
  5. 重启 Node.js 服务器
  6. 再次点击“启动服务器”，以重新连接 Unity 编辑器的 WebSocket 到 Node.js MCP 服务器

[!TIP]
您的 AI 编码 IDE（例如 Claude Desktop、Cursor IDE、Windsurf IDE）与 MCP 服务器之间的超时取决于 IDE。

可选：允许远程 MCP 桥接连接

默认情况下，WebSocket 服务器绑定到 'localhost'。要允许其他机器上的 MCP 桥接连接：

  1. 打开 Unity 编辑器
  2. 导航到工具 > MCP Unity > 服务器窗口
  3. 启用“允许远程连接”复选框
  4. Unity 将将 WebSocket 服务器绑定到 '0.0.0.0'（所有接口）
  5. 重启 Node.js 服务器以应用新的主机配置
  6. 当远程运行 MCP 桥接时，设置环境变量 UNITY_HOST 为您的 Unity 机器的 IP 地址：UNITY_HOST=192.168.1.100 node server.js

<a name="debug-server"></a>调试服务器

<details> <summary><span style="font-size: 1.1em; font-weight: bold;">构建 Node.js 服务器</span></summary>

MCP Unity 服务器是使用 Node.js 构建的。它需要将 TypeScript 代码编译到 build 目录中的 JavaScript。 如果有问题，可以通过以下方式强制安装：

  1. 打开 Unity 编辑器
  2. 导航到工具 > MCP Unity > 服务器窗口
  3. 点击“强制安装服务器”按钮

安装

如果您想手动构建，可以遵循以下步骤：

  1. 打开终端/PowerShell/命令提示符

  2. 导航到服务器目录：

    cd ABSOLUTE/PATH/TO/mcp-unity/Server~

  3. 安装依赖项：

    npm install

  4. 构建服务器：

    npm run build

  5. 运行服务器：

    node build/index.js
</details> <details> <summary><span style="font-size: 1.1em; font-weight: bold;">使用 MCP Inspector 调试</span></summary>

使用 @modelcontextprotocol/inspector 调试服务器：

  • PowerShell
npx @modelcontextprotocol/inspector node Server~/build/index.js
  • 命令提示符/终端
npx @modelcontextprotocol/inspector node Server~/build/index.js

不要忘记在关闭终端或使用 [MCP Inspector](