콘텐츠로 이동
Search

QMD

lastmod 2026-11-16created 2026-01-313 edits

QMD(Query Markup Documents)는 Shopify 의 Tobi Lütke 가 만든 로컬 문서 검색 엔진으로, Markdown 노트·회의록·문서를 색인해 키워드나 자연어로 찾는다. BM25 전문 검색, 벡터 검색, LLM 재순위화를 한 파이프라인으로 묶고, 쓰는 모델은 모두 node-llama-cpp 로 기기 안에서 돌린다. 결과를 JSON 이나 파일 목록으로 내고 MCP 서버를 함께 제공해 코딩 에이전트가 검색 도구로 쓰기 좋게 만들었다.

About

  • 폴더를 collection 으로 등록하고 qmd embed 로 임베딩을 만듦. collection·하위 경로에 설명(context)을 달아 두면 검색 결과와 함께 돌려줘 LLM 이 문서를 고를 때 참고함
  • 검색 명령은 search(BM25), vsearch(벡터), query(질의 확장 + 두 검색 + 재순위화). get·multi-get 으로 문서를 경로·docid·glob 으로 꺼냄
  • query 는 질의를 lex·vec·HyDE 로 확장해 SQLite FTS5 와 sqlite-vec 에 나눠 보내고, Reciprocal Rank Fusion 으로 합친 뒤 재순위화함. 상위 1~3위는 검색 점수 75%, 11위 이하는 재순위 점수 60% 로 섞어 원래 질의에 정확히 맞는 문서를 지킴
  • 문서는 약 900토큰 단위로 자르되 제목·코드 블록·빈 줄 같은 Markdown 경계에 점수를 매겨 가장 자연스러운 곳에서 끊음
  • 기본 GGUF 모델은 embeddinggemma-300M(약 300MB), qwen3-reranker-0.6B(약 640MB), 질의 확장용으로 미세 조정한 qmd-query-expansion-1.7B(약 1.1GB). 한중일 문서에는 Qwen3-Embedding-0.6B 로 바꿀 수 있고, OpenAI 호환 원격 임베딩도 설정 가능
  • MCP 서버는 stdio 와 HTTP(qmd mcp --http, 기본 8181 포트)를 지원하고 query·get·multi_get·status·metadata 도구를 줌. Claude Code 플러그인도 있음
  • TypeScript 로 작성, Node.js 22 이상이나 Bun 에서 동작. npm install -g @tobilu/qmd 로 설치하고 Node·Bun 용 라이브러리로도 씀
  • MIT 라이선스

See also

Favorite site

author Zer0, MCPBot sitemap