Docker uv.lock 동결 + streamable_http_client 마이그레이션

Dockerfile이 uv pip install .만 하고 uv.lock을 동결하지 않으면 mcp>=1.0이 PyPI mcp 2.x로 올라가고, deprecated streamablehttp_client가 사라져 이미지가 CrashLoop(ImportError)한다.

전형 실패

ImportError: cannot import name 'streamablehttp_client'
  from 'mcp.client.streamable_http'

롤백만 하면 payload/trim 등 후속 커밋이 클러스터에 안 올라온다. 배포 축은 Test-Overlay-vs-Release-Package-Deploy-Paths.md.

수정 패턴

  1. COPY uv.lock + uv export --frozen (또는 동등 frozen install).
  2. 범위 핀: mcp>=1.27.1,<2 (2.x API와 분리).
  3. 클라이언트 import를 **streamable_http_client**로 마이그레이션 (python-sdk migration).
  4. CI/이미지에 python -c "from mcp.client.streamable_http import streamable_http_client" 계약 테스트.

교차 스키

stdio MCP host의 pydantic/fastmcp 스키와는 축이 다름 — MCP-Python-Package-Skew-Import-Failure.md. 본 패턴은 앱 이미지 런타임 import.

🔗 관련 문서