Hermes가 설정을 도와주길 원하시나요? 이 가이드를 전달하고, 기존 설정을 모두 보존하면서 mcp_servers 항목을 준비하고 도구 검증 방법까지 설명해 달라고 요청하세요. DeepSeek API 키는 로컬에서 설정하고 프롬프트에 붙여 넣지 마세요.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는 자체 CLI에서 MCP를 핵심 기능으로 제공합니다. 서버 추가, 연결 테스트, 노출할 도구 선택, 열려 있는 세션에서 MCP 다시 불러오기를 할 수 있습니다. 조사 기능을 에이전트 워크플로에 상시 포함하려면 Hermes에 MCP 서버를 계속 연결해 두세요. 가끔 검색만 한다면 터미널에서 작은 헬퍼를 직접 실행할 수도 있습니다. Hermes MCP 가이드
Hermes에서 DeepSeek Search 추가하기
MCP 도구 필터에서 어댑터가 노출할 기능을 선택하고, 비공개 환경 파일로 DeepSeek 자격 증명을 보호합니다.
Node.js 22 이상을 준비하고 Claude Code 설정 가이드에 따라 로컬 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 설정 및 필터링
CLI 마법사를 사용하려면 hermes mcp를 실행한 다음 사용자 지정 서버 추가를 선택합니다. 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 런타임 동작
공식 문서에 관한 질문을 검색하고 가장 적합한 결과를 Fetch한 뒤 페이지 URL을 인용해 달라고 요청하세요. 도구 실행 기록에 Search와 Fetch가 모두 포함되는지 확인합니다. 연결 테스트가 통과해도 DeepSeek 인증이 검증된 것은 아닙니다. 어댑터가 유료 요청을 보낼 때 API 키를 확인합니다.
필요한 도구만 의도적으로 공개하기
Search와 Fetch는 서로 다른 일을 합니다. Search는 후보 페이지와 요약을 찾고, Fetch는 선택한 페이지를 읽어 출처를 확인합니다. 조사 중심 프로필에서는 두 도구를 모두 공개하세요. 최신 사실 하나만 확인하면 되는 코딩 세션에서는 MCP 서버를 비활성화하고 헬퍼를 직접 실행할 수 있습니다. Hermes에서는 enabled: false로 항목을 비활성화할 수 있고 tools.include로 작은 도구 집합만 선택하거나 이름으로 도구를 제외할 수도 있습니다.
도구가 보이지 않으면 탐색 결과에 표시된 정확한 MCP 도구 ID와 include 필터를 비교하세요. 이름이 잘못되면 서버에 연결되더라도 호출 가능한 도구가 하나도 없을 수 있습니다. 키 파일을 만든 셸뿐 아니라 Hermes 프로세스에도 해당 파일을 읽을 권한이 있는지 확인하세요.
한 번만 검색할 때는 셸 헬퍼 사용하기
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 명령으로 가져옵니다. 이 방식은 수동 확인이나 셸 중심 워크플로에 적합하지만 Hermes에 이름이 지정된 Search 도구를 제공하지 않습니다. MCP 설정 없이 단일 검색을 cURL로 직접 요청할 수도 있습니다. DeepSeek의 Search 및 Fetch API 가이드에서 요청 형식과 현재 요금을 확인한 다음 대량 요청을 실행하세요.
흔한 설정 문제 해결하기
hermes mcp test에서 명령을 찾을 수 없다고 하면 설정에 Node의 전체 경로를 지정하세요. 연결은 성공했지만 Hermes가 도구를 호출하지 못한다면 tools.include를 검색 결과의 도구 이름과 대조하고 MCP를 다시 불러오세요. 인증 실패가 발생하면 비공개 환경 파일을 수정하고 어댑터를 실행하는 세션을 다시 시작합니다. 요청 헤더나 로컬 경로가 들어 있는 상세 진단 정보를 공개 이슈에 붙여 넣지 마세요.
Hermes가 선택된 도구를 검색하고 새 세션 또는 다시 불러온 세션에서 사용하며, Search와 Fetch 이후 출처가 포함된 답을 반환하면 설정이 끝난 것입니다. 키는 안전하게 보관하고 요약을 신뢰하기 전에 Fetch가 반환한 1차 출처를 직접 여세요.
저자: Martin Hayes. Auspia에서 200개 이상의 GEO 실행 체크리스트를 설계했습니다. 실용적인 설정 가이드와 재사용 가능한 구현 체크리스트를 씁니다.
