qdrant-mcp-server (유지 관리되는 포크)

유지 보수가 중단된 PyPI 패키지 qdrant-mcp-server 0.1.0 (저자: fiyen; upstream github.com/fiyen/qdrant-mcp-server은 현재 404 — PR을 보낼 저장소가 존재하지 않으므로) 의 포크입니다.

이 포크가 존재하는 이유

기존 패키지는 __init__에서 sentence-transformers/all-MiniLM-L6-v2 모델을 eager(즉시) 로드합니다. stdio MCP server이기 때문에서, 모든 agent runtime/세션이 각각자만의 복사본은 생성하고, N개d의 대기(idle) 세션이 N × ~1.35 GB의 중복 로드된 모델 메모supports를 차지하게 됩니다 (실측: 5 copy = 5.7 GB). 이일반화된 "generalized"에 대한 글 — "stdio" 트래프 글을 참고하세요.

Related MCP server: Qdrant MCP Server

PyPI 0.1.0 대비 변경사항

• Lazy-load 적용: 임베딩 모델은 시작 시점이 아닌, 첫 generate_embedding 호출 때에만 로드됩니다. 대기 상태의 복사본은 약 ~30 MB만 사융합니다. (lazy-load.patch — 저장소 트의 수정 — 참조요이)

설치 (기존 PyPI 설치 대체)

uv tool install --force git+https://github.com/Ripnrip/qdrant-mcp-server

기존의 MCP 설정 (command = /Users/admin/.local/bin/qdrant-mcp-server)은 그대로 작동하며, 향후 uv tool upgrade는 죽은 PyPI 0.1.0이 아닌 이 포크에서 패키지를 받아옵니다.

재설치 후에는 실행 중인 qdrant-mcp-server 인스턴스를 재시작하세요. Swift reaper LaunchAgent이 orphan 된 pro세스를 정리합니다 (com.local.qdrant-mcp-reaper).

Context: HAB-J354 · /~/Documents/Developer/qdrant-mcp-ram-fix-2026-08-24/