Hermes Agent MCP 指南

MCP 在 Hermes 里扮演什么角色

可以把 MCP 看成一个外部能力接入层：Hermes 负责推理与执行任务，MCP Server 负责暴露工具， 而你则决定 Hermes 能看到哪些工具、资源和提示。这样既灵活，又更容易做权限边界控制。

最小可用配置示例

mcp_servers:
  project_fs:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/my-project"]

从单一、安全、作用域清晰的文件系统服务器开始，通常比“一上来接一堆服务”更容易验证、排错和控制风险。

为什么一定要做工具过滤

• 避免把危险或无关的操作直接暴露给模型。
• 减少工具数量，让 Hermes 更容易选对动作。
• 对数据库、支付、内部 API 等敏感系统尤其重要。
• 推荐优先使用白名单（include），必要时再补黑名单（exclude）。

常见使用场景

• 项目助手：让 Hermes 读取特定仓库、分析结构、总结改动。
• GitHub 协作：列问题、查代码、生成 issue 草稿或总结讨论。
• 内部系统接入：通过 MCP 连接公司 API、数据库、文档系统或知识库。
• 自动化工作流：把 MCP 与 cron、消息网关和长期记忆结合起来。

Hermes Agent 的 MCP 适合什么场景？

当你希望 Hermes 通过一个清晰的 RPC 层访问本地文件、GitHub、数据库、内部 API 或公司系统时，MCP 是很合适的选择。它尤其适合需要扩展工具边界、又不想直接改 Hermes 核心代码的场景。

MCP 和内置工具有什么区别？

内置工具是 Hermes 自带能力，开箱即可用；MCP 则更像一个外部能力接入层，让你按需连接更多工具和系统。通常建议先用内置工具，确认不够时再引入 MCP。

为什么要做 include / exclude 过滤？

因为很多 MCP Server 会暴露大量工具。对敏感系统、数据库或第三方服务来说，最好一开始就做白名单或黑名单，避免让模型看到不必要或危险的操作。