MMCPMarkets
DC

darkamenosa/contextqmd-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

11 stars 1 forks Качество 76 Тренд 22MIT
Repository Install

MCP server for local-first library documentation via ContextQMD

Обзор

MCP server for local-first, version-aware library documentation. Install, search, and retrieve docs for any library directly from your AI coding assistant. 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. 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. Add to your MCP client configuration (e.g., Claude Desktop, Cursor, etc.

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.
Открыть полный README на GitHub

Установка

npx -y contextqmd-mcp
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

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