[email protected]을 통해 2026-07-28 Model Context Protocol (MCP) specification 및 MCP TypeScript SDK v2 지원이 가능해졌습니다.
우리는 원래 Next, Nuxt, Svelte 등을 포함한 인기 있는 웹 프레임워크에서 MCP 서버를 더 쉽게 구축할 수 있도록 mcp-handler를 제작했습니다.
새로운 2.0 릴리스를 통해 핸들러는 다음을 지원합니다:
- 네이티브로 제공되는 상태 비저장 (stateless) 프로토콜로, 요청당 메타데이터 및 서버/발견 (server/discovery) 기능을 포함한
2026-07-28 사양을 지원합니다.
- 2025년형 Streamable HTTP를 사용하는 클라이언트를 위한 상태 비저장 (stateless) 호환 계층을 제공합니다.
- Redis 의존성이나 세션 저장소 없이 두 프로토콜을 모두 지원합니다.
기존의 상태 비저장 (stateless) Streamable HTTP 클라이언트는 서버가 최신 프로토콜을 채택하는 동안에도 동일한 엔드포인트 /mcp에 계속 연결할 수 있습니다.
새로운 패키지를 설치하세요:
Next.js 라우트 핸들러를 생성하세요:
MCP 클라이언트는 /api/mcp에 연결할 수 있습니다.
2.0 버전으로 업데이트된 mcp-handler를 사용하여 시작하세요: Next.js MCP server template
버전 2는 Node.js 20 이상과 zod를 필요로 하며, @modelcontextprotocol/sdk를 @modelcontextprotocol/server로 대체합니다.
도구 (Tool), 프롬프트 (prompt), 리소스 (resource) 정의는 이제 SDK v2 등록 API와 z.object(...)와 같은 Standard Schema 입력을 사용합니다 (registerTool).
더 이상 사용되지 않는 (deprecated) HTTP+SSE 전송 방식이 제거되었습니다. /sse로의 요청은 410 Gone을 반환합니다. 클라이언트가 여전히 해당 전송 방식에 의존하고 있다면, Streamable HTTP로 마이그레이션하는 동안 1.x 버전을 유지하세요.
더 읽어보기
업그레이드 전 주의사항