Hermes_Agent最新虚幻引擎5.8 MCP接入配置教程

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

整个流程拆解下来，关键步骤包括：启用 Hermes MCP 客户端、配置 config.yaml、重启 Hermes，然后将 unreal-mcp-server 部署上去（可使用二进制文件或从源码编译）。前提是 UE5.8 已开启 Python 支持。最后验证工具列表和版本调用是否通畅。

确认 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

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 通道已成功打通。