跳到主要內容
MCP

Hermes Agent MCP 指南

如果你搜索的是「Hermes Agent MCP」「Hermes Agent MCP Server 怎么配」， 这页先告诉你最重要的结论：先连接一个安全、范围小的服务器，再马上做工具过滤。

What Is MCP

MCP 在 Hermes 裡扮演什麼角色

可以把 MCP 看成一個外部能力接入層：Hermes 負責推理與執行任務，MCP Server 負責暴露工具， 而你則決定 Hermes 能看到哪些工具、資源和提示。這樣既靈活，又更容易做權限邊界控制。

先理解 MCP 概念 ↗
CN Docs MCP

只想讓 Agent 查中文文檔？直接接入社區端點

https://mcp.hermesagent.org.cn/v1

這是 Hermes 中文社區維護的文檔檢索 MCP server，使用 Streamable HTTP， 無需 API Key、無需登錄。配置時直接使用上面的標準 HTTPS 地址； 當前生產入口由騰訊雲服務器上的 OpenResty 提供，Cloudflare 只做 DNS 解析，不走 Tunnel。

查看新手接入說明 ↗
Starter Config

最小可用配置示例

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

從單一、安全、作用域清晰的文件系統服務器開始，通常比“一上來接一堆服務”更容易驗證、排錯和控制風險。

查看完整 MCP 指南 ↗
Filtering

為什麼一定要做工具過濾

  • 避免把危險或無關的操作直接暴露給模型。
  • 減少工具數量，讓 Hermes 更容易選對動作。
  • 對數據庫、支付、內部 API 等敏感系統尤其重要。
  • 推薦優先使用白名單（include），必要時再補黑名單（exclude）。
MCP 配置參考工具參考
Use Cases

常見使用場景

  • 項目助手：讓 Hermes 讀取特定倉庫、分析結構、總結改動。
  • GitHub 協作：列問題、查代碼、生成 issue 草稿或總結討論。
  • 內部系統接入：通過 MCP 連接公司 API、數據庫、文檔系統或知識庫。
  • 自動化工作流：把 MCP 與 cron、消息網關和長期記憶結合起來。
FAQ

Hermes Agent 的 MCP 适合什么场景？

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

FAQ

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

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

FAQ

为什么要做 include / exclude 过滤？

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