Claude Desktop MCP Filesystem: 'Server disconnected' 오류 해결 및 nvm 사용자 가이드

핵심 기술

본 콘텐츠는 Claude Desktop의 Model Context Protocol(MCP) 파일 시스템 기능 설정 시 발생하는 "MCP filesystem: Server disconnected" 오류를 해결하는 방법을 제시합니다. 특히 Node Version Manager(nvm) 사용자가 Node.js 실행 경로 문제를 겪을 때 유용한 해결책을 제공합니다.

기술적 세부사항

• 문제점: nvm으로 설치된 Node.js 실행 파일에 MCP 서버 명령이 직접 접근하지 못하여 발생하는 오류.
• 해결책: nvm 환경을 올바르게 인식하는 래퍼 스크립트(wrapper script)를 생성하여 문제를 해결.
  • which node 명령어로 nvm 기반 Node.js 경로 확인.
  • /usr/local/bin/npx-for-claude 파일 생성 및 내용 작성:
    bash export PATH="/Users/YOUR-USERNAME/.nvm/versions/node/YOUR-NODE-VERSION/bin:$PATH" exec npx "$@"
    • YOUR-USERNAME 및 YOUR-NODE-VERSION은 실제 값으로 대체 필요.
  • chmod +x /usr/local/bin/npx-for-claude 명령어로 스크립트 실행 권한 부여.
  • claude_desktop_config.json 파일 수정하여 command 필드에 npx-for-claude 지정:
    json {"mcpServers":{"filesystem":{"command":"npx-for-claude","args":["-y","@modelcontextprotocol/server-filesystem","/Users/username/path/to/allowed/directory"]}}}
• 작동 원리: 래퍼 스크립트가 올바른 PATH 환경을 설정하고 npx 명령을 인자와 함께 실행함으로써 Claude Desktop과 nvm 환경 간의 연결성을 확보.

개발 임팩트

이 해결책은 nvm 사용자가 Claude Desktop의 MCP 기능 설정을 성공적으로 완료하도록 도와, AI 모델과의 원활한 연동 및 개발 생산성 향상에 기여합니다.

커뮤니티 반응

이 해결책은 ModelContextProtocol GitHub 저장소의 이슈 #64에 대한 코멘트에서 영감을 받았으며, 해당 이슈에 기여자로 등록되어 있습니다.