
darkamenosa/contextqmd-mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
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을 통해 결과를 제공합니다.
흐름을 설치 번들 우선:
- 라이브러리 카탈로그를 검색하고 라이브러리/버전을 선택하십시오.
- fetch 표시
- 다운로드
tar.gz사용할 때 docs 번들 - SHA256 체크섬을 확인하고 로컬 캐시로 포장
- QMD를 가진 색인
- 로컬 검색
호환 번들가 누락되면 서버가 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:
- search the library catalog and choose a library/version
- fetch manifest
- download a
tar.gzdocs bundle when available - verify SHA256 checksum and unpack into the local cache
- index with QMD
- 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.
설치
npx -y contextqmd-mcp설정
{
"mcpServers": {
"contextqmd": {
"command": "npx",
"args": ["-y", "contextqmd-mcp"]
}
}
}