Skip to content

v0.2.0

Choose a tag to compare

@dongju93 dongju93 released this 24 Aug 17:07
· 14 commits to main since this release
94210f6

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에서는 이 서버의 도구 목록 조회와 도구 호출을 지원하지 않습니다.