Hermes Agent 连接 MCP 服务时，如果服务一启动就退出，优先查命令路径、工作目录、环境变量和 stderr 日志。MCP 配置看起来像 JSON/YAML 小问题，但真实故障经常是“命令在 Hermes 的运行环境里找不到”。
先在终端复现
把 MCP 配置里的 command 和 args 复制到同一个用户、同一个 shell 里执行。如果终端都跑不起来，Hermes 也不会神奇跑起来。常见情况包括 Node/Python 不在 PATH、虚拟环境没激活、包没安装、脚本路径用了相对路径。
四个重点检查点
- command 用绝对路径测试一次，例如
/usr/bin/node或 venv 里的 python。 - cwd 是否正确：很多 MCP server 需要在项目根目录启动。
- env 是否完整：API Key、配置路径、代理变量不要只存在于交互式 shell。
- 日志是否有 stderr：服务退出前通常会打印真正原因。
不要把所有 MCP 都一起开
排查时只启用一个 MCP server，确认它能稳定启动、列出工具、执行一个最小请求后，再接入下一个。多个 MCP 同时失败时，日志会混在一起，很难判断是谁退出。
如果 MCP 在 Cursor 或 Claude Code 里能跑，在 Hermes 里不能跑，多半是启动环境不同。把路径、cwd、env 显式写进 Hermes MCP 配置，比依赖 shell 隐式状态更稳定。
