mcp-handler@2.0.0을 통해 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 버전을 유지하세요.

더 읽어보기

업그레이드 전 주의사항