Hermes Agent 的 MCP server 在 Docker 里启动失败，先不要怀疑 MCP 配置全错，重点查 npx、npm、node 这些裸命令在容器里的 PATH。Hermes Agent v0.15.1 已在 2026 年 5 月 29 日修复了 Docker 下 MCP 裸命令解析问题，会把这些命令解析到 /usr/local/bin，避免容器里明明有 Node 工具链却启动不起来。
这个问题通常长什么样
你在本机执行 npx 没问题，但 Hermes Agent 在 Docker 后端调用 MCP server 时没有正常拉起；有时日志只看到 MCP 连接失败、工具列表为空，甚至像是“悄悄失败”。这类情况很容易被误判成 API key 错、MCP manifest 写错，实际可能只是容器内进程拿到的 PATH 不包含 Node 所在位置。
排查时先做三件事
- 先升级 Hermes Agent 到 v0.15.1，避免踩 v0.15.0 的已知 Docker PATH 问题。
- 进入容器执行
which node、which npm、which npx，确认实际路径。 - 如果你暂时不能升级，把 MCP 配置里的裸命令改成绝对路径，例如
/usr/local/bin/npx。
如果换成绝对路径后能启动，说明问题基本就在 PATH，不要继续大改 MCP 参数。升级后再把配置恢复成更通用的裸命令也可以，但要保留一份可回滚备份，尤其是团队共用配置。
还有哪些情况不是 PATH
如果 npx 已经能被找到，但 MCP 仍失败，再看三类问题：需要交互输入但容器里无法交互；MCP server 需要的环境变量没传进容器；镜像里缺少运行时依赖。判断顺序建议是“命令能否找到、依赖能否启动、凭证是否齐全、Hermes 是否能连接”。这样排查最快，也最少误删配置。
