vercel-labs/mcp-handler

해결하는 문제

mcp-handler는 JavaScript 및 TypeScript 애플리케이션에서 Model Context Protocol (MCP) 서버를 호스팅할 수 있게 해주는 프레임워크 독립적 HTTP 어댑터입니다. 웹 표준 Request 및 Response API를 사용하는 최신 웹 프레임워크에 MCP 서버를 배포할 때 프레임워크별 보일러플레이트 코드를 작성할 필요가 없습니다.

작동 방식

이 라이브러리는 MCP 서버 정의를 표준 웹 표준 (Request) => Promise<Response> 핸들러로 변환하는 createMcpHandler 함수를 제공합니다. 이 핸들러는 Next.js, Nuxt/Nitro, SvelteKit, Hono와 같은 프레임워크의 라우트에 직접 마운트할 수 있습니다. 2026-07-28 MCP 사양(스테이트리스)을 기본적으로 지원하며, 2025년형 Streamable HTTP 클라이언트에 대한 투명한 폴백을 제공합니다.

대상 사용자

JavaScript 또는 TypeScript를 사용하여 MCP 서버를 구축하고, Fetch 호환 API를 지원하는 서버리스 또는 엣지 호환 프레임워크에 배포하려는 개발자.

주요 특징

• 프레임워크 독립적: 웹 표준 Request 및 Response API를 노출하는 모든 프레임워크에서 작동합니다.
• 듀얼 프로토콜 지원: 최신 2026-07-28 스테이트리스 프로토콜과 2025년형 Streamable HTTP를 단일 핸들러에서 모두 처리합니다.
• 배포 간소화: 스테이트리스 작업을 위해 Redis나 복잡한 세션 관리를 설정할 필요가 없습니다.
• TypeScript 지원: 타입 안전한 개발 경험을 위한 전체 타입 정의가 포함되어 있습니다.