Claude MCP 서버 직접 제작 핸즈온 | TypeScript 버전 및 공개까지 [무료 샘플 2개 공개]

이 글에서 알 수 있는 것

**MCP (Model Context Protocol)**는 Anthropic이 2024년 11월에 공개한 오픈 사양입니다. Claude와 로컬 파일 또는 API를 '표준 프로토콜'로 연결하는 다리 역할을 합니다.

기존에는 Claude가 로컬 데이터나 API에 접근하도록 하려면, 프롬프트

추가하고, 실제 툴 정의(tools/list 및 tools/call의 핸들러)를 구현해 나가는 흐름이 될 것입니다.

용도별 서버 구성 예시로는 다음과 같은 것들이 생각해 볼 수 있습니다.

Echo 서버: 첫 동작 확인용. 입력을 그대로 반환만 하는 최소 구성부터 시작하면, MCP의 통신 구조를 이해하기 쉽습니다.
파일 읽기 서버: Claude가 로컬 파일을 참조하게 하고 싶은 경우. 경로를 받아서 fs.readFile로 반환하는 것만으로도 실용적으로 사용할 수 있습니다.
외부 API 연동 서버: 날씨 API나 Slack, Notion 등 외부 서비스를 Claude에서 조작하고 싶을 때. zod로 요청의 유효성 검사(validation)를 넣는 것이 안전합니다.

기반만 단단하게 갖춰지면, 이제부터는 툴의 개수만 늘려가면 됩니다. 최종적으로는 npm publish로 패키지로 공개하여 다른 사람도 사용할 수 있는 상태를 목표로 할 수 있습니다.

완전판 핸즈온 자료에서는 이 기사의 기반 내용 외에도 다음 내용을 한 권에 정리했습니다.

이 기사의 무료 부분만으로도 환경 구축의 힌트로 참고가 되셨으면 좋겠습니다. 직접 손을 움직이며 읽는 것이 가장 많이 배운다고 필자는 생각합니다.