MCP 서버 직접 만들어보기
Model Context Protocol 서버를 TypeScript로 만들고 Claude Desktop에 연결하는 최소 예제. 커스텀 도구 하나 추가까지.
MCP가 뭔가
Model Context Protocol은 LLM이 외부 도구·데이터와 이야기하는 표준 규약입니다.
1단계: 프로젝트 세팅
mkdir my-mcp && cd my-mcp
npm init -y
npm install @modelcontextprotocol/sdk zod
2단계: 서버 코드 작성
index.ts에 기본 서버를 만듭니다.
3단계: 도구 하나 추가
add 같은 간단한 함수부터.
4단계: Claude Desktop 설정
claude_desktop_config.json에 서버 경로 등록.
5단계: 테스트
Claude Desktop을 재시작하고 도구를 호출해봅니다.
6단계: 배포
npm 패키지로 올리거나, 사내용이면 로컬 경로 그대로.