DC

darkamenosa/contextqmd-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

11 stars 1 forks 품질 76 트렌드 12MIT

ContextQMD를 통해 로컬 최초의 라이브러리 문서에 대한 MCP 서버

개요

MCP Server for local-first, version-aware 라이브러리 문서. AI 코딩 조수에서 직접 라이브러리에 대한 설치, 검색 및 검색 docs. ContextQMD는 문서를 로컬로 유지하는 context7의 대안입니다. ContextQMD 레지스트리에서 doc 패키지를 다운로드하고, QMD (BM25 + 벡터 + LLM reranking)로 색인하고, Model Context Protocol을 통해 결과를 제공합니다. 1. 라이브러리 카탈로그를 검색하고 라이브러리 / 버전 2. fetch 나 3. 다운로드 tar.gz docs 번 사용할 수 4. 확인 SHA256 체크섬 및 로컬 캐시에 해제 5. QMD 6. 로컬 검색 호환 번들가 누락되면 서버는 페이지 색인 플러스 페이지 fetches로 돌아갑니다. 설치는 실패에 롤백과 원자입니다. MCP 클라이언트 구성에 추가 (예 : Claude Desktop, Cursor 등).

개요(AI 번역)

MCP Server for local-first, version-aware 라이브러리 문서. AI 코딩 조수에서 직접 라이브러리에 대한 설치, 검색 및 검색 docs.

무엇 그것

ContextQMD는 문서를 로컬로 유지하는 context7의 대안입니다. ContextQMD 레지스트리에서 doc 패키지를 다운로드하고, QMD (BM25 + 벡터 + LLM reranking)로 색인하고, Model Context Protocol을 통해 결과를 제공합니다.

흐름을 설치 번들 우선:

  1. 라이브러리 카탈로그를 검색하고 라이브러리/버전을 선택하십시오.
  2. fetch 표시
  3. 다운로드 tar.gz 사용할 때 docs 번들
  4. SHA256 체크섬을 확인하고 로컬 캐시로 포장
  5. QMD를 가진 색인
  6. 로컬 검색

호환 번들가 누락되면 서버가 page-index]로 돌아갑니다. 설치는 실패에 롤백과 원자입니다.

설치

또는 npx로 직접 실행:

MCP 구성

MCP 클라이언트 구성에 추가 (예 : Claude Desktop, Cursor 등) :

또는 글로벌 설치 경우:

CLI 옵션

사용 가능한 도구

도구 설명
[T2] 원격 라이브러리 카탈로그를 검색합니다. 버전, 별명, 소스 메타데이터 및 로컬 설치 상태와 함께 후보를 반환합니다.

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

contextqmd-mcp

MCP server for local-first, version-aware library documentation. Install, search, and retrieve docs for any library directly from your AI coding assistant.

What it does

ContextQMD is an alternative to context7 that keeps documentation local. It downloads doc packages from the ContextQMD registry, indexes them with QMD (BM25 + vector + LLM reranking), and serves results through the Model Context Protocol.

Install flow is bundle-first:

  1. search the library catalog and choose a library/version
  2. fetch manifest
  3. download a tar.gz docs bundle when available
  4. verify SHA256 checksum and unpack into the local cache
  5. index with QMD
  6. search locally

If a compatible bundle is missing, the server falls back to page-index plus per-page fetches. Installs are atomic with rollback on failure.

Install

npm install -g contextqmd-mcp

Or run directly with npx:

npx contextqmd-mcp

MCP Configuration

Add to your MCP client configuration (e.g., Claude Desktop, Cursor, etc.):

{
  "mcpServers": {
    "contextqmd": {
      "command": "npx",
      "args": ["-y", "contextqmd-mcp"]
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "contextqmd": {
      "command": "contextqmd-mcp"
    }
  }
}

CLI Options

--transport   Transport type: stdio (default) or http
--port      HTTP port (default: 3001)
--registry     Registry URL override
--token      API token
--cache-dir   Cache directory override

Available Tools

Tool Description
search_libraries Search the remote library catalog. Returns candidates with versions, aliases, source metadata, and local install status.
install_docs Install a documentation package. Bundle-first with SHA256 verification; falls back to page API. Atomic with rollback. Idempotent — skips if already installed with same manifest checksum.
update_docs Update installed docs to latest version or refresh when manifest checksum changes. Rolls back on failure.
search_docs Search installed documentation locally. Returns page-level results with snippets, line anchors, and scores. Supports auto/fts/vector/hybrid modes.
get_doc Read a bounded slice from a locally installed page by doc_path or page_uid. Supports sequential reads (from_line/max_lines) and context windows (around_line/before/after).
list_installed_docs List all locally installed documentation packages with metadata.
remove_docs Remove an installed documentation version or all versions for a library. Cleans up both cache and search index.

Search Modes

search_docs supports four modes via the mode parameter:

  • auto (default) — Smart routing based on query classification: short keyword queries use FTS, conceptual/how-to questions use vector, complex multi-aspect queries use hybrid.
GitHub에서 전체 README 보기

설치

npx -y contextqmd-mcp
MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "contextqmd": { "command": "npx", "args": ["-y", "contextqmd-mcp"] } } }