7월 28일 확정된 무상태 규격에 맞춰 깃허브 별 1만 개짜리 타입스크립트 프레임워크 mcp-use가 v2(2.0.4)로 처음부터 다시 만들어졌고, 공식 타입스크립트 SDK도 @modelcontextprotocol/core·client·server 2.0.0 세 묶음으로 쪼개져 그 밑에 깔렸어요(예전 통합 묶음 @modelcontextprotocol/sdk 는 1.30.0에 그대로예요). 이전 안내 문서를 보면 세션 저장소와 세션 붙박이 라우팅이 통째로 빠지고, stdio 서빙·익스프레스 어댑터·ctx.sample() 은 '옮길 경로가 없다'고 못 박혀 있어요. Node 22.22.2 이상에 ESM 전용이라 v1 프로젝트를 그대로 올려서는 안 돌아가요.
용어 풀이
- MCP
- Model Context Protocol. AI 도구·모델이 바깥 도구·데이터에 붙는 방식을 정한 표준 규격
- SDK
- 어떤 규격·서비스를 쓰기 쉽게 묶어 놓은 개발용 꾸러미
- stdio
- 표준 입출력. 웹 주소 없이 프로그램끼리 직접 입출력으로 주고받게 서버를 띄우는 방식
- ESM
- 자바스크립트 표준 모듈 방식. require 대신 import 로 불러오는 쪽
운영자 인사이트
무상태로 가면 세션 붙박이가 사라져 요청을 어느 서버에 흘려도 되지만, 그 값은 이전 문서에 적혀 있어요 — 로컬에서 stdio로 띄우던 사내 MCP 서버는 v2로 옮길 경로가 없고, 세션에 걸어 둔 상태는 애플리케이션 저장소로 빼야 해요. 지난주 내려받기에서 새 공식 서버 묶음은 118만 건, 예전 통합 묶음은 5,542만 건이라 생태계는 아직 거의 안 움직였어요.
여러 관점으로 보기
- 옮기려면 무엇이 깨지나 세션 저장소·세션 복구·세션 붙박이 라우팅이 v2에 아예 없고, stdio 서빙과 익스프레스 어댑터, 서버 쪽 샘플링(ctx.sample())은 '옮길 경로가 없다'고 문서가 못 박아요. 도구는 schema 대신 inputSchema, ctx.req 는 ctx.request 로 바뀌고 Node 22.22.2 이상·ESM 전용이에요. mcp-use 문서
- 규격 쪽 근거 7월 28일 개정판이 initialize 교환과 Mcp-Session-Id 헤더를 없애서, 요청이 저마다 규격 버전과 신원을 들고 다니고 아무 서버에나 떨어져도 되게 바뀌었어요. Model Context Protocol 블로그
- 생태계는 얼마나 옮겼나 7월 30일~8월 5일 내려받기에서 새 공식 서버 묶음은 118만 건인데, 같은 주 예전 통합 묶음은 5,542만 건이에요. npm
- 도구 실체 별 10.5k·포크 1.4k·열린 이슈 38건에 MIT 라이선스이고, 저장소 첫 화면부터 v1 쓰던 사람에게 이전 안내 문서를 가리켜요. GitHub