想让 Hermes 帮你配置？ 把本文交给它，请它准备 mcp_servers 配置、保留现有设置，并说明如何验证工具。请在本机添加 DeepSeek 密钥，切勿在提示词中发送密钥。Follow this guide to add DeepSeek Search to Hermes Agent. Inspect my current
~/.hermes/config.yaml first and preserve every existing MCP server. Prepare a
stdio entry that reads the key from my private env file, expose only the
Search and Fetch tools, and show me the change before saving. Do not read,
print, or transmit the key in chat. Run the Hermes MCP test, then wait for my
approval before making a paid DeepSeek request.Hermes 将 MCP 作为 CLI 的一等功能：你可以添加服务器、测试连接、选择要公开的工具，也能在已打开的会话中重新加载 MCP。配置思路很直接：如果联网研究属于 Agent 日常工作流，就使用 Hermes 的持久 MCP 连接；如果只是偶尔查一次资料，则直接从终端运行小型辅助程序。Hermes MCP 指南
从 Hermes 添加 DeepSeek Search
MCP 工具筛选器决定转接器公开哪些功能；私密环境文件保存 DeepSeek 凭证。
请参阅 Claude Code 设置指南，使用 Node.js 22 或更新版本，在私有目录中安装本机 DeepSeek Search 转接器及其固定版本依赖包。创建单独的环境文件，写入 DEEPSEEK_API_KEY=...，并限制文件读取权限。请勿将密钥写入 config.yaml、项目文件或对话纪录。
Hermes 的交互式 mcp add 流程可以新增本机 stdio 服务器并探测连接。若需要精确、可重复的设置，请将下列内容放在 ~/.hermes/config.yaml 的 mcp_servers 之下：
mcp_servers:
deepseek-search:
command: node
args:
- --env-file=/Users/you/.config/deepseek-search/.env
- /Users/you/.local/share/deepseek-search/server.mjs
enabled: true
timeout: 30
tools:
include:
- deepseek_search
- deepseek_fetchinclude 清单中的工具名称必须与转接器公开的名称一致。启用筛选器前，请查看转接器的 README 或工具探索结果；如果名称不同，请照抄准确 ID。Hermes 通过 command、args 和 env 支援 stdio MCP 服务器，并由筛选层只注册所选工具。Hermes MCP 设置与筛选
如果想使用 Hermes 的 CLI 向导，请运行 hermes mcp，选择新增自定义服务器。CLI 的 hermes mcp add 可接受服务器名称，以及 URL 或 stdio 指令；之后也能通过 hermes mcp configure 调整要启用的工具。保存前，请先使用检测流程并检查建议的工具清单。Hermes CLI MCP 指令
测试注册状态，再加载工具
连接测试、加载会话和通过认证的 DeepSeek 请求是不同的检查步骤。
请 Hermes 测试已设置的服务器：
hermes mcp test deepseek-search
hermes mcp list测试会确认 Hermes 能否连接并探索到工具。如果你手动编辑了 YAML，请重新启动 hermes chat，或在现有会话中使用 /reload-mcp。Hermes 文件指出，MCP 工具会在启动时探索，也能在会话期间重新加载。Hermes MCP 执行行为
接着请 Hermes 搜寻一个与官方文件有关的问题、抓取最合适的结果，并引用页面网址。确认工具纪录里同时出现 Search 和 Fetch。连接测试通过并不能验证 DeepSeek 身份认证；只有转接器发出可能收费的请求时，才会检查 API 密钥。
有意识地选择公开哪些工具
Search 和 Fetch 的用途不同：Search 找出候选页面与摘要；Fetch 读取选定页面，以便核对来源。以研究为主的配置档建议同时公开两者。如果程序开发会话只需要查证一个即时事实，可以停用 MCP 服务器，改为手动运行辅助程序。Hermes 支援以 enabled: false 停用项目，也可用 tools.include 选择少量工具，或按名称排除工具。
如果找不到工具，请检查探索结果报告的确切 MCP ID，以及 include 筛选清单。即使服务器已连接，名称拼错仍会导致没有任何可呼叫工具。也要确认 Hermes 程序本身可读取密钥文件，而不只是建立文件的 Shell 环境可以读取。
偶尔搜寻时使用 Shell 辅助程序
如果不希望 Hermes 长期加载另一台 MCP 服务器，可以直接运行 CLI 辅助程序。沿用 Claude Code 指南中的 search-cli.mjs，并将环境文件保存在项目之外：
node --env-file=/Users/you/.config/deepseek-search/.env \
/Users/you/.local/share/deepseek-search/search-cli.mjs \
search "Hermes Agent official MCP configuration" 3使用辅助程序的 fetch 命令抓取所选结果。这适合手动检查或以 Shell 为主的工作流；不过 Hermes 不会因此获得具名 Search 工具。你也可以针对单一查询直接使用 cURL，而不设置 MCP。DeepSeek 的 Search 与 Fetch API 指南说明了请求格式和现行计费方式，大量查询前请先查阅。
排查常见设置问题
如果 hermes mcp test 报告找不到指令，请在设置中填写 Node 的完整路径。如果连接成功但 Hermes 无法呼叫工具，请将 tools.include 与转接器探索到的名称逐一比对，并重新加载 MCP。如果工具报告身份验证失败，请修正私密环境文件，并重新启动负责该转接器的会话。不要将包含请求头或本机路径的详细诊断信息贴到公开议题中。
当 Hermes 能探索所选工具、在新的或重新加载的聊天中加载它们，并在 Search 和 Fetch 后给出附带来源的回答，设置就完成了。请妥善保管密钥，并在依赖摘要之前先打开 Fetch 回来的第一手来源。
作者：Martin Hayes，Auspia 200 多份 GEO 执行清单的设计者。Martin 撰写实用的设置指南与可重复使用的实施检查清单。
