Hermes Agent最新虚幻引擎5.8的MCP接入如何配置

想要让 Hermes Agent 自动化操控虚幻引擎 5.8 项目，实现项目打包、资源导入、蓝图编译、关卡数据读取等操作，需依托专用 UE5.8 MCP Server 并基于 MCP 协议完成对接。本文详细讲解 Hermes MCP 客户端激活、UE5.8 专属服务端构建、服务注册、环境配置与连通验证的完整流程，同时标注关键避坑要点。

确认 Hermes 已启用 MCP Client

打开终端执行：。

hermes config show --section mcp

如果返回空或报错no such section，说明 MCP 客户端未激活。

进入配置目录：cd ~/.hermes/config → 编辑config.yaml → 在根层级添加以下区块（注意缩进为【2 个空格】）：

mcp:
  enabled: true
  client:
    timeout: 15

完成之后 必须重启 Hermes 才能生效 ：关闭当前进程 → 运行hermes start。

不重启，后续所有 MCP server 都无法被发现。

构建 UE5.8 专用 MCP Server

虚幻引擎 5.8 不支持直接暴露 HTTP 接口，必须通过其内置的 Python 脚本环境+Unreal Python API 桥接 MCP 标准协议。

推荐使用官方推荐的unreal-mcp-server轻量实现（v0.4.2 起支持 UE5.8.1+）。

方法一：用预编译二进制（仅限 Windows/Linux x64）

1. 访问站点；
2. 下载unreal-mcp-server-v0.4.2-win64.exe（Windows）或unreal-mcp-server-v0.4.2-linux-amd64（Linux）；
3. 然后放入 UE5.8 安装目录下的Engine/Extras/ThirdPartyNotices子目录（确保路径无中文、空格）；
4. 设置可执行权限：chmod +x unreal-mcp-server-v0.4.2-linux-amd64。

方法二：源码编译（推荐 macOS 及调试场景）

1. 克隆仓库：git clone https://github.com/nousresearch/unreal-mcp-server.git ；
2. 进入目录：cd unreal-mcp-server ；
3. 检出适配分支：git checkout ue5.8-py311；
4. 安装依赖：uv pip install -r requirements.txt ；
5. 构建：python build.py --ue-path "/Applications/Epic Games/UE_5.8"（macOS 路径示例）；
6. 输出物位于dist/下，含unreal_mcp_server可执行文件。

注意：UE5.8 必须启用 Python 支持——在编辑器中打开Edit → Editor Preferences → General → Python，勾选Enable Python Support并重启编辑器；否则 server 启动后无法加载unreal模块，会报ModuleNotFoundError: No module named 'unreal'。

注册并启动 UE5.8 MCP Server

第一步：编辑~/.hermes/config.yaml，在mcp_servers节点下新增条目：

- name: "unreal58"
  command: "/path/to/unreal-mcp-server-v0.4.2-win64.exe"
  args: ["--project", "D:/Projects/MyGame.uproject", "--port", "8081"]
  env:
    UE_PYTHONPATH: "D:/Epic Games/UE_5.8/Engine/Source/Programs/UnrealEditor/UnrealEditor.exe"

第二步：确保args中--project指向真实存在的.uproject文件，且该路径不能含中文或特殊符号；否则 server 启动时会卡在“Loading project…”阶段超过 30 秒后超时退出。

第三步：重启 Hermes，执行hermes run --tool-list，观察输出中是否出现unreal58.*开头的工具名（如unreal58.build_windows、unreal58.import_fbx）。

第四步：验证连通性，启动 UE5.8 编辑器并打开对应项目，在 Hermes 中输入：run tool unreal58.get_editor_version，成功返回{"version": "5.8.1", "build": "21474"}即表示 MCP 通道打通。

结语

完成 Hermes 客户端开启、MCP 服务端编译部署、项目路径配置与服务注册重启后，即可打通 Hermes Agent 与 UE5.8 编辑器的通信通道。整套配置核心是开启引擎 Python 支持、保证路径规范、正确写入配置文件并重启服务，配置无误后，可全面实现各类 UE5 项目自动化运维与开发操作。

以上关于Hermes Agent最新虚幻引擎5.8的MCP接入如何配置的文章就介绍到这了，更多相关内容请搜索码云笔记以前的文章或继续浏览下面的相关文章，希望大家以后多多支持码云笔记。