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.
수정 패턴
COPY uv.lock+uv export --frozen(또는 동등 frozen install).- 범위 핀:
mcp>=1.27.1,<2(2.x API와 분리). - 클라이언트 import를 **
streamable_http_client**로 마이그레이션 (python-sdk migration). - 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.