Claude에서 로컬 MCP 서버를 TypeScript로 구성 및 실행 시 문제 해결 가이드

핵심 기술: 본 글은 Claude의 로컬 MCP 서버를 TypeScript로 구축하는 과정에서 발생하는 일반적인 설정 및 실행 오류를 해결하는 데 초점을 맞춥니다. 특히 Node.js의 직접적인 TypeScript 실행 기능과 관련된 문제들을 다룹니다.

기술적 세부사항:
* TypeScript 직접 실행: Node.js v23.6+에서 지원하는 --experimental-strip-types 옵션을 사용하여 별도의 빌드 과정 없이 .ts 파일을 직접 실행하는 방법을 설명합니다.
* nvm 및 Node.js 버전 관리: nvm을 사용하여 Node.js 23 버전을 설치하고 nvm-exec를 통해 해당 버전의 Node.js를 명시적으로 호출하는 방법을 제시합니다.
* 절대 경로 사용: Claude의 config.json에서 환경 변수 상속이나 경로 보간이 지원되지 않으므로, nvm-exec 및 실행할 스크립트 파일에 절대 경로를 명시해야 함을 강조합니다.
* 실험적 기능 경고 처리: --experimental-strip-types 옵션 사용 시 발생하는 ExperimentalWarning이 MCP 프로토콜(stdin/stdout)을 방해하는 문제를 --disable-warning=ExperimentalWarning 옵션을 통해 해결하는 방법을 공유합니다.
* 작동하는 config.json 예시: 문제 해결 후 최종적으로 작동하는 config.json 설정을 제공합니다.

개발 임팩트: 이 가이드는 로컬 환경에서 LLM과의 상호작용을 위한 MCP 서버 설정을 간소화하고, Node.js의 최신 기능을 활용하는 데 도움을 줍니다. 개발자는 불필요한 빌드 단계를 줄이고, 버전 충돌이나 실행 오류 없이 신속하게 개발 환경을 구축할 수 있습니다.

커뮤니티 반응: (원문 내용에 커뮤니티 반응에 대한 직접적인 언급은 없습니다.)