MCP·에이전트 만들기

도구 하나를 가진 가장 작은 MCP 서버를 TypeScript로 처음부터 만든다. 패키지 준비부터 Claude Code에 붙여 굴리기까지 단계별로 따라간다.

stdio MCP 서버에서 console.log 한 줄이 연결을 통째로 깨뜨릴 수 있다. stdout이 통신 채널인 이유와, 로그를 stderr로 보내야 하는 까닭을 짚는다.

MCP 클라이언트와 서버는 stdio 또는 HTTP로 연결된다. 두 transport의 동작 방식과 언제 무엇을 골라야 하는지 정리한다.

MCP 서버가 LLM에게 노출하는 세 가지 기본 요소 Tools·Resources·Prompts를 각각 언제 쓰는지 구분한다.

LLM은 혼자 외부 세계를 만지지 못한다. MCP가 그 연결을 어떻게 표준화하는지, 클라이언트·서버 구조와 도구 정의를 통해 살펴본다.