要使用 Hermes Agent 真正操控 UE5.8 项目——例如自动化打包 Windows 构建、批量导入 FBX、触发蓝图编译、读取关卡元数据——必须通过 MCP 协议连接一个专门定制的服务端。目前官方并未提供现成的整合包，需要自行搭建并注册为受信任的本地服务。

整个流程分解下来，实际上只需几个关键步骤：启用 Hermes MCP 客户端、编辑 config.yaml 配置、重启 Hermes，然后部署 unreal-mcp-server——既可以使用预编译二进制文件，也可以从源码编译。前提条件是 UE5.8 已经开启了 Python 支持。最后一步是验证工具列表及版本调用是否畅通。

检查 Hermes 是否已启用 MCP 客户端

先打开终端，执行一条命令：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

UE5.8 本身并不直接支持暴露 HTTP 接口，因此需要通过其内置的 Python 脚本环境，借助 Unreal Python API，将 MCP 标准协议桥接过来。推荐使用官方提供的 unreal-mcp-server，v0.4.2 版本已支持 UE5.8.1 及以上版本。

方法一：使用预编译二进制（仅适用于 Windows 或 Linux x64）
直接前往 GitHub releases 页面下载对应的可执行文件——Windows 请下载 unreal-mcp-server-v0.4.2-win64.exe，Linux 请下载 unreal-mcp-server-v0.4.2-linux-amd64。将其放置到 UE5.8 安装目录下的 Engine/Extras/ThirdPartyNotices 子目录中，务必确保路径不包含中文和空格。然后赋予可执行权限：chmod +x unreal-mcp-server-v0.4.2-linux-amd64。

方法二：从源码编译（更适合 macOS 或需要调试的场景）
先克隆仓库：git clone https://github.com/nousresearch/unreal-mcp-server.git，然后进入目录：cd unreal-mcp-server。切换到适配分支：git checkout ue5.8-py311。接着安装依赖：uv pip install -r requirements.txt。最后执行构建：python build.py --ue-path "/Applications/Epic Games/UE_5.8"（此为 macOS 路径示例）。编译产物位于 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 通道已完全打通。