MCP 파일시스템: 서버 연결 중단

분야

프로그래밍/소프트웨어 개발

대상자

Node.js 및 nvm을 사용하는 클라우드 데스크탑 앱 개발자, MCP 구성 오류 해결 필요자

난이도: 중급 (Node.js 환경 구성 이해 필요)

핵심 요약

• *_MCP 파일시스템: 서버 연결 중단_** 오류는 nvm 설치된 Node.js 실행 파일을 MCP 서버 명령어 환경에서 직접 접근할 수 없을 때 발생합니다.
• *핵심 해결 방법**: nvm 환경을 정확히 인식하도록 npx-for-claude 워래퍼 스크립트 작성
• *코드 강조**: npx-for-claude, claude_desktop_config.json
• *설계 원칙**: PATH 환경 변수 설정을 통한 실행 환경 통합

섹션별 세부 요약

1. 문제 진단

• MCP 서버 연결 실패 시 "MCP 파일시스템: 서버 연결 중단" 오류 발생
• nvm로 설치된 Node.js 실행 파일이 MCP 서버 명령어 환경에서 접근 불가
• claude_desktop_config.json 파일 구성 오류는 주요 원인 중 하나

1. 해결 방법

• which node 명령어로 nvm 설치 경로 확인 (예: /Users/username/.nvm/versions/node/v16.x.x/bin/node)
• /usr/local/bin/npx-for-claude 파일 생성 및 다음 내용 작성

```bash

export PATH="/Users/YOUR-USERNAME/.nvm/versions/node/YOUR-NODE-VERSION/bin:$PATH"

exec npx "$@"

```

• 파일 권한 설정: chmod +x /usr/local/bin/npx-for-claude
• claude_desktop_config.json 파일에서 npx-for-claude 스크립트 사용

```json

{"mcpServers":{"filesystem":{"command":"npx-for-claude","args":["-y","@modelcontextprotocol/server-filesystem","/Users/username/path/to/allowed/directory"]}}}

```

1. 해결 메커니즘

• 워래퍼 스크립트는 정확한 PATH 환경 변수 설정을 통해 nvm Node.js 실행 파일 접근 가능
• npx 명령어를 통해 MCP 서버 패키지 실행
• 클라우드 데스크탑 앱 실행 환경과 nvm 설정 간의 경로 통합

1. 참고 사항

• GitHub Issue #64에서 제안된 해결책을 기반으로 개발
• claude_desktop_config.json 파일 수정 후 앱 재시작 필수

결론

• *_npx-for-claude_** 워래퍼 스크립트를 통해 nvm 환경에서 MCP 서버 연결 문제 해결 가능.
• *실무 팁**:

1. which node로 정확한 Node.js 경로 확인
2. claude_desktop_config.json 파일에서 npx-for-claude 스크립트 사용
3. 권한 설정 및 앱 재시작으로 구성 적용

이 방법은 MCP 서버 실행 환경과 nvm 설정 간의 호환성을 확보하여 구성 오류를 방지합니다.