modelcontextprotocol/typescript-sdk

Model Context Protocol (MCP) TypeScript SDK – 빠른 개요

무엇인가요 – Model Context Protocol (MCP) 서버와 클라이언트를 구축할 수 있는 TypeScript 라이브러리 세트입니다. MCP는 대규모 언어 모델에 구조화된 컨텍스트(도구, 리소스, 프롬프트 등)를 공급하기 위한 가볍고 언어 독립적인 사양입니다. 이 SDK는 2026년 7월 사양을 구현하며 Node.js, Bun, Deno에서 실행됩니다.

주요 패키지

• @modelcontextprotocol/server – 도구와 리소스를 정의하고 HTTP, stdio, 또는 기타 전송 방식을 통해 노출하는 도우미.
• @modelcontextprotocol/client – 서버의 기능을 탐지하고 도구를 호출하는 유틸리티.
• Express, Fastify, Hono, 일반 Node HTTP용 옵션 미들웨어 어댑터(@modelcontextprotocol/express, fastify, hono, node)는 MCP를 인기 있는 웹 프레임워크에 쉽게 통합할 수 있게 합니다.

사용 방법

1. 서버 생성 – McpServer 인스턴스를 생성하고 Zod(또는 호환 가능한) 스키마로 도구를 등록한 후, 전송 방식(예: StdioServerTransport)을 연결합니다.
2. 클라이언트 생성 – 클라이언트 패키지를 사용해 서버에 연결하고 사용 가능한 도구를 목록화하고 호출합니다.
3. 배포 – 미들웨어 패키지를 통해 HTTP 런타임에 서버를 연결합니다.

중요성 – LLM 호출과 컨텍스트 제공을 분리함으로써 MCP는 동일한 도구 정의를 다양한 모델, 클라우드 공급자, 또는 온디바이스 런타임에서 재사용할 수 있게 합니다. SDK는 자체 프로토콜 처리를 구현하지 않고도 사양을 타입 세이프하게 채택할 수 있는 즉시 사용 가능한 방법을 제공합니다.

문서 및 지원 – 완전한 가이드, API 참조, 마이그레이션 노트는 https://ts.sdk.modelcontextprotocol.io/v2/ 에 게시되어 있습니다. GitHub에서 이슈를 열 수 있으며, 프로젝트는 Apache-2.0(신규 코드) / MIT(레거시) 라이선스입니다.

---

TL;DR

• 목적: LLM에 구조화된 컨텍스트를 제공하는 MCP 준수 서비스를 구축하고 사용하는 것.
• 언어: TypeScript (Node, Bun, Deno).
• 핵심 라이브러리: @modelcontextprotocol/server 및 @modelcontextprotocol/client.
• 추가 기능: Express, Fastify, Hono, 일반 Node HTTP용 가벼운 어댑터.
• 시작 방법: npm i @modelcontextprotocol/server @modelcontextprotocol/client를 실행한 후 "첫 번째 서버/클라이언트" 튜토리얼을 따라주세요.