jgravelle/jdocmunch-mcp

View on GitHub ↗

The leading, most token-efficient MCP server for documentation exploration and retrieval via structured section indexing

202 ★44 forksPythonUpdated 18d ago

What you need to know

Local-first MCP server that indexes a documentation set by heading hierarchy and retrieves the exact section an agent needs — byte-precisely — instead of loading whole files into the context window.

Install

uv tool install jdocmunch-mcp
jdocmunch-mcp init

Usage

  • Index docs with jdocmunch-mcp index-local --path ./docs (or index_repo straight from a GitHub repository).
  • Inside your agent, call search_sections then get_section on the top hit, and read _meta.tokens_saved.
  • Add 'Call the jdocmunch_guide tool and strictly follow its instructions.' to CLAUDE.md to break the brute-read habit.
  • Use get_toc_tree for structure, the doc-health tools, and the OpenAPI tools as needed.

Key features

  • Section-first retrieval with byte-precise extraction from exact offsets in the original file.
  • Stable section IDs across re-indexing when path, heading text, and heading level are unchanged.
  • Hybrid search (BM25 + optional provider-agnostic embeddings); 64 tools total.
  • Document health radar: coverage, stale pages, orphan sections, broken links, and undocumented symbols.
  • Local-only with a versioned index that auto-migrates on first load; no hosted service required.

Best for

Keeping large documentation sets out of an agent's context window while answering precise doc questions.

Caveats

  • Dual-use license: free for personal/non-commercial use; commercial use requires a paid one-time license (jDocMunch only: Builder $29, Studio $99, Platform $499; full jMunch suite higher).
  • Section retrieval helps least on small files; semantic search requires an embedding provider, otherwise search is lexical only.
  • Office formats (PDF, DOCX, PPTX, EPUB) need the optional [office] extra and are local-indexing only.
  • Does not parse code (that's jcodemunch-mcp) or tabular data (jdatamunch-mcp); freshness is disclosed, not guaranteed.
  • Anonymous savings counter on by default (no content/PII); opt out with JDOCMUNCH_SHARE_SAVINGS=0.
Platforms: LocalClients: Claude Code

Reviewed 2026-08-18

Topics

claudeclaude-codecodexcopilotcursordocsdocumentationdocumentation-toolgemini-clillmmarkdownmcpmcp-servermodel-context-protocolopenapisemantic-searchtechnical-writingtoken-optimizationwikiwindsurf
Stars
202★
Forks
44
Language
Python
License
NOASSERTION
Created
2026-03-04
Last push
2026-08-17