# jDocmunch MCP

Hands your agent one documentation section instead of a whole file. Useful when the reference set is large and context fills up with text nobody asked for.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 206
- Author: jgravelle
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/jgravelle/jdocmunch-mcp
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/jdocmunch-mcp

## What it does

jDocmunch parses a documentation set into a tree of sections keyed by heading hierarchy, then records each section's byte offsets in the source file. An agent can ask for a single section, a heading subtree, or a ranked search hit, and gets back just that slice. Section identities survive re-indexing as long as the path, heading text and heading level stay the same.

Setup is a normal MCP install: `uv tool install jdocmunch-mcp`, then `jdocmunch-mcp init`. The init step finds your MCP clients, writes their config entries, adds a prompt policy so the agent actually reaches for the tools, and can install hooks and index docs. You need Python 3.10+ and an MCP-compatible client. Hooks are the exception to the zero-install path: a minimal-PATH subshell resolves the executable by name, so they need `uv tool install` (or `pipx`/`pip`).

Index a local folder with `jdocmunch-mcp index-local --path ./docs`. The JSON reply reports file and section counts; sections outnumber files because the index addresses headings, not files. Installing the server alone won't stop an agent from brute-reading files. One line in `CLAUDE.md` does that — call `jdocmunch_guide` and follow it.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add jdocmunch-mcp -- uvx jdocmunch-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from jdocmunch-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add jdocmunch-mcp -- uvx jdocmunch-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from jdocmunch-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "jdocmunch-mcp": {
            "command": "uvx",
            "args": [
                "jdocmunch-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from jdocmunch-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "jdocmunch-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "jdocmunch-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from jdocmunch-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add jdocmunch-mcp uvx jdocmunch-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from jdocmunch-mcp <command>

## When to use it
- pull one relevant section out of a large doc set without opening the file
- fetch a heading subtree for a specific topic
- index a docs folder and search across sections
- cut context use when answering a configuration question
- keep stable references to sections across re-indexing

## Example prompts
- Search the docs for the authentication setup section and show it to me
- Index the `./docs` folder and tell me how many sections it found
- Find the section on node affinity and return only that part

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md