최신 MCP 사양 지원 추가
mcp-handler가 2026-07-28 MCP 사양과 SDK v2를 지원하도록 바뀌었습니다.
교안에 영향
예전의 /sse와 /message 안내는 더 이상 맞지 않으며, HTTP+SSE를 쓰던 클라이언트는 mcp-handler 1.x 안내를 따라야 합니다.
요약
- mcp-handler가 2026-07-28 Model Context Protocol 사양과 MCP TypeScript SDK v2를 지원합니다. - 서버는 상태를 두지 않는 최신 프로토콜을 네이티브로 제공하고, 요청별 메타데이터와 server/discover를 포함합니다. - 2025년식 Streamable HTTP 클라이언트를 위한 호환 계층을 제공하며, Redis나 세션 저장소 없이 동작합니다. - HTTP+SSE 전송 방식은 제거되었고, /sse와 /message 요청은 410 Gone을 반환합니다. - Node.js 20 이상, zod4, @modelcontextprotocol/server가 필요하며 tool, prompt, resource 정의 방식이 SDK v2 등록 API로 바뀌었습니다.
바뀐 것
새 기능
- mcp-handler가 2026-07-28 Model Context Protocol 사양을 지원합니다.
- MCP TypeScript SDK v2를 지원합니다.
- 상태를 두지 않는 2026-07-28 프로토콜을 네이티브로 제공합니다.
- 요청별 메타데이터와 server/discover를 지원합니다.
- 2025년식 Streamable HTTP를 사용하는 클라이언트를 위한 호환 계층을 제공합니다.
개선
- Redis 의존성이나 세션 저장소 없이 두 프로토콜을 모두 사용할 수 있습니다.
- tool, prompt, resource 정의가 SDK v2 등록 API와 Standard Schema 입력 방식을 사용하도록 바뀌었습니다.
기타
- 기존 상태 없는 Streamable HTTP 클라이언트는 같은 /mcp 엔드포인트로 계속 연결할 수 있습니다.
- Next.js 경로 핸들러와 Next.js MCP 서버 템플릿이 mcp-handler 2.0에 맞게 갱신되었습니다.
- 버전 2는 Node.js 20 이상과 zod4를 요구하고, @modelcontextprotocol/sdk를 @modelcontextprotocol/server로 대체합니다.
지원 종료
- HTTP+SSE 전송 방식이 제거되었습니다.
- /sse와 /message 요청은 410 Gone을 반환합니다.