You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This commit was created on GitHub.com and signed with GitHub’s verified signature.
Release Notes
v0.2.0
주요 내용
npm 패키지 조회를 전체 packument가 아닌 정확한 버전의 매니페스트 문서 단위로 전환하여, 대형 패키지에서도 조회가 안정적으로 성공하도록 개선했습니다.
Python 런타임 버전을 패치 구성요소까지 포함한 정확한 릴리스로 강제하고, 근거 없이 supported로 내려가던 경로를 차단해 판정의 보수성을 강화했습니다.
MCP SDK 의존성을 <2.1로 고정해 서버가 검증한 프로토콜 계약이 설치 시점에 우회되지 않도록 했습니다.
추가
PyPI 게시 워크플로에 --check-url 옵션을 추가했습니다. 내용이 동일한 재업로드는 실패 대신 건너뛰므로, 문서만 변경된 병합도 릴리스 작업을 통과합니다.
변경
npm 어댑터가 packument 전체가 아닌 버전별 매니페스트를 조회하도록 변경했습니다. react, typescript 같은 대형 패키지에서 응답 본문 상한(5 MiB) 초과로 lookup_failed / response_too_large가 나오던 문제가 해소되며, 문서가 작아져 조회 속도와 캐시 효율도 함께 좋아집니다.
requires_python의 상한이 열려 있고 해당 Python 라인의 지원 종료 정보를 공식 게시처에서 확보할 수 없는 경우, 더 이상 supported로 내려가지 않고 unknown / insufficient_evidence(lifecycle_unavailable)를 반환하도록 판정 절차를 변경했습니다. 근거 없는 긍정 판정을 원천적으로 차단합니다.
README의 설치 및 실행 안내를 보강했습니다. uvx를 통한 stdio 실행, HTTP 호스팅, Docker를 이용한 공개 배포 절차를 명확히 정리했습니다.
Docker 이미지의 Python 베이스를 3.14.7로 올리고, Cloud Run에서의 바인드 주소 결정 동작을 Dockerfile 주석으로 명시했습니다.
버그 수정
Python 런타임 대상에 마이너 버전만 입력된 경우(3.13) 릴리스 인덱스 조회 끝에서 release_not_found로 돌아오던 문제를 수정했습니다. 이제 입력 경계에서 runtime_patch_required 입력 오류로 안내하며, 오류 메시지는 올바른 표기(3.13.7) 예시를 함께 제공합니다.
npm 매니페스트 문서가 예상한 형태와 일치하지 않으면 조회 실패가 아닌 invalid_document로 처리하도록 수정했습니다. 잘못된 문서가 빈 결과처럼 보이지 않습니다.
호환성 및 주요 변경
runtime:python 대상의 version은 이제 major.minor.patch 세 자리를 모두 포함해야 합니다. 3.13 같은 마이너 라인 표기는 입력 오류로 거절됩니다. Node.js 런타임은 기존과 같이 정확한 SemVer 릴리스를 요구합니다.
mcp 의존성을 <2.1로 제한했습니다. 서버는 SDK의 프로토콜 버전 상수에 대한 생성 시점 검증(_pin_protocol_version())에 의존하는데, 이 상한이 없으면 설치 관리자가 사용자 대신 넓어진 SDK를 채택해 계약을 깨뜨릴 수 있습니다.
보안
외부 공개된 보안 취약점 수정은 없습니다.
알려진 문제
MCP 2026-07-28 프로토콜을 지원하지 않는 클라이언트에서는 서버에 연결할 수 없습니다. 현재 Codex에서는 이 서버의 도구 목록 조회와 도구 호출을 지원하지 않습니다.