Hermes Agent 连接 MCP 后工具变少，很多时候是正常现象，不一定是服务器坏了。Hermes 会尊重每个 MCP server 的 tools.include、tools.exclude、resources 和 prompts 配置；如果你把工具白名单收得很窄，界面里自然只会看到一小部分工具。
按症状排查
| 现象 | 优先检查 |
|---|---|
| 整个 MCP 不加载 | enabled: false、命令路径、运行时、HTTP 地址 |
| 只缺几个工具 | tools.include 和 tools.exclude |
| 看不到资源或 prompts | resources: false、prompts: false 或服务器本身不支持 |
| 改完配置还是旧状态 | 在会话里执行 /reload-mcp |
为什么官方建议先收窄工具
MCP 的强大之处在于能让 Hermes Agent 同时连接文件系统、GitHub、文档、内部 API 等工具。但工具越多，误调用和权限风险也越高。对 GitHub、财务系统、客户系统这类有写操作的服务，建议一开始只放少量只读或低风险工具，确认流程可靠后再逐步开放。
新手最稳的配置思路
先接一个文件系统或 git MCP，只暴露一个项目目录；再接 GitHub MCP，只放 list_issues、search_code 这类低风险工具。确认 Hermes Agent 能正确调用后，再增加创建 issue、更新状态等动作。看到工具少，不要第一反应就是全开，先问：这些工具是不是当前任务真的需要。
官方开源地址：https://github.com/NousResearch/hermes-agent；官方文档入口：https://hermes-agent.nousresearch.com/。
