Posts

MCP Resource는 도구가 아니라 LLM이 읽어들이는 데이터다. 도구와 무엇이 다른지, URI로 무엇을 노출하는지, 그리고 실제 서버에서 어떻게 구현하는지 살펴본다.

마크다운 폴더를 스키마가 붙은 타입 안전한 데이터로 바꾸는 Astro Content Collection. 컬렉션 정의부터 목록·상세 페이지 렌더링까지 블로그 한 채를 통째로 만들어본다.

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

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

개인 블로그의 글을 데이터베이스가 아니라 마크다운 파일과 git으로 관리하면 무엇이 좋은가. 저장소 선택이 프로젝트의 성격을 어떻게 바꾸는지 짚는다.

TS 파일인데 import에는 .js를 쓴다. 어색해 보이는 이 규칙이 사실 Node ESM과 tsc 동작의 필연적 결과임을 짚는다.

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

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

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