Hermes 에이전트의 MCP 서버가 Docker에서 시작되지 않는다면, MCP 설정이 완전히 잘못됐다고 생각하지 마세요. 컨테이너 내 npx, npm, node 명령어의 경로를 확인하는 데 집중하세요. Hermes 에이전트 v0.15.1은 2026년 5월 29일 Docker에서 MCP 원시 명령어 파싱 문제를 수정했습니다. 이 명령어들을 /usr/local/bin로 파싱하여 Node 툴체인이 있어도 컨테이너가 시작되지 않도록 합니다.
이 질문은 보통 이런 식으로 나옵니다
로컬에서 npx 실행하지만, Hermes 에이전트가 Docker 백엔드의 MCP 서버를 호출할 때 제대로 불러오지 않습니다; 때로는 로그에 MCP 연결 실패, 빈 공구 목록, 심지어 '조용한 실패'만 표시되기도 합니다. 이러한 상황은 잘못된 API 키나 잘못된 MCP 매니페스트 작성으로 쉽게 오해될 수 있습니다; 실제로는 컨테이너 내 프로세스가 얻는 PATH에 노드 위치가 포함되어 있지 않을 수도 있습니다.
조사할 때는 먼저 세 가지를 하세요
- 먼저, Hermes 에이전트를 v0.15.1로 업그레이드하여 v0.15.0에서 발생했던 Docker PATH 문제를 피하세요.
- 컨테이너에 들어가
which node,which npm,which npx을 실행하여 실제 경로를 확인합니다. - 지금 업그레이드가 어렵다면, MCP 구성에서 bare 명령을 절대 경로(absolute path)로 바꾸세요, 예를 들어
/usr/local/bin/npx.
절대 경로로 전환한 후에 문제가 시작된다면, 기본적으로 문제는 PATH에 있다는 뜻입니다. MCP 파라미터를 계속 극적으로 바꾸지 마세요. 업그레이드 후에는 구성을 더 일반적인 기본 명령어로 복원할 수 있지만, 특히 팀 공유 구성의 경우 롤 가능한 백업을 반드시 유지해야 합니다.
PATH가 아닌 다른 상황은 무엇인가요?
npx를 찾을 수 있지만 MCP가 여전히 실패한다면, 세 가지 유형의 문제를 살펴보세요: 대화형 입력이 필요하지만 컨테이너가 상호작용할 수 없음; MCP 서버가 요구하는 환경 변수는 컨테이너에 전달되지 않았으며; 이 이미지는 런타임 의존성이 없습니다. 판단 순서는 다음과 같습니다: "명령어를 찾을 수 있는가, 의존성을 시작할 수 있는가, 자격 증명이 완료되었는지, 그리고 Hermes가 연결할 수 있는가?" 이렇게 하면 문제 해결이 가장 빠르고 설정을 실수로 삭제할 가능성이 적습니다.
