JDocMunch MCP

왜 쓰나요

핵심 기능

섹션 수준 검색 — 관련 내용만 가져오기
교차 참조 추적 — 전체 페이지를 다시 가져오지 않고 링크 추적
인덱싱 가능한 모든 문서 사이트에서 작동 (HTML, Markdown)
반복 쿼리를 위한 로컬 캐시
호출당 토큰 사용량 측정 — Claude가 비용을 볼 수 있음

라이브 데모

실제 사용 모습

jdocmunch-mcp.replay ▶ 준비됨

0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "jdocmunch-mcp": {
      "command": "uvx",
      "args": [
        "jdocmunch-mcp"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "jdocmunch-mcp": {
      "command": "uvx",
      "args": [
        "jdocmunch-mcp"
      ]
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "jdocmunch-mcp": {
      "command": "uvx",
      "args": [
        "jdocmunch-mcp"
      ]
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "jdocmunch-mcp": {
      "command": "uvx",
      "args": [
        "jdocmunch-mcp"
      ]
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "jdocmunch-mcp",
      "command": "uvx",
      "args": [
        "jdocmunch-mcp"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "jdocmunch-mcp": {
      "command": {
        "path": "uvx",
        "args": [
          "jdocmunch-mcp"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add jdocmunch-mcp -- uvx jdocmunch-mcp

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: JDocMunch MCP

대용량 문서 사이트에서 필요한 API 참조 섹션만 가져오기

👤 클라우드 SDK를 사용하는 개발자 ⏱ ~10 min beginner

언제 쓸까: AWS SDK 문서가 200페이지고 Claude가 전부 가져오려 할 때.

사전 조건

문서 URL 또는 로컬 문서 트리 — 첫 번째 호출: 문서 인덱싱; 이후 호출은 캐시 사용

흐름

인덱싱

Use jdocmunch. Index the AWS S3 SDK docs at the URL. Show me top-level sections.✓ 복사됨

→ 목차 트리 반환, 전체 내용 아직 없음
드릴다운

Show only the section on multipart upload — code samples included, intro skipped.✓ 복사됨

→ 대상 섹션 내용
링크 따라가기

Now follow the link to 'Aborting incomplete uploads' from that section.✓ 복사됨

→ 링크된 섹션 가져와짐

결과: 80k 토큰이 아닌 2k 토큰으로 답변.

함정

문서 구조에 이상한 앵커 (PDF 전용) — 먼저 Markdown으로 변환; jdocmunch는 Markdown을 가장 잘 파싱

함께 쓰기: filesystem

두 SDK 버전 간 API 문서 섹션 비교

👤 의존성을 업그레이드하는 개발자 ⏱ ~20 min intermediate

언제 쓸까: v3에서 v4로 이동 중; 변경 사항의 정밀한 diff를 원할 때.

흐름

양쪽 인덱싱

Index doc-v3 and doc-v4. List sections that exist only in v4 or have changed.✓ 복사됨

→ 섹션 diff 목록
변경된 섹션 드릴다운

Show changes in the 'Authentication' section between v3 and v4.✓ 복사됨

→ 섹션별 diff

결과: 문서 자체에서 구축된 마이그레이션 가이드.

함정

버전 간 섹션 ID 변경 — 앵커 대신 헤딩 텍스트로 매칭

조합

다른 MCP와 조합해 10배 효율

jdocmunch-mcp + filesystem

검색된 섹션을 프로젝트 노트에 저장

jdocmunch-mcp + git-mcp-idosal

문서와 소스 오브 트루스 소스 코드 연결

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
index	url_or_path	문서 집합 처음 접근 시	가져오기 + 파싱 1회
list_sections	doc_id, depth?	목차 탐색	무료 (캐시)
get_section	doc_id, section_path	단일 섹션 가져오기	무료 (캐시)
follow_link	doc_id, from_section, link_target	교차 참조 추적	무료 (캐시)

비용 및 제한

운영 비용

API 쿼터: 호스트의 robots 정책에 따름
호출당 토큰: 구조화된 검색으로 100–800
금액: 무료
팁: 한 번 인덱싱하고 여러 번 쿼리 — 캐시가 후속 요청을 저렴하게 만듦

보안

권한, 시크릿, 파급범위

최소 스코프: 인덱싱을 위한 아웃바운드 HTTP

자격 증명 저장: 공개 문서는 없음

데이터 외부 송신: 인덱싱하는 문서 호스트

절대 부여 금지: 인증 제어 없이 내부 비공개 문서 인덱싱

문제 해결

자주 발생하는 오류와 해결

JS가 많은 문서 사이트에서 인덱스 파싱 실패

일부 사이트는 헤드리스 브라우저가 필요함; 정적 내보내기가 있는지 확인

재인덱싱 후 섹션 누락

문서 구조가 변경됨; 캐시를 비우고 재인덱싱

uvx에서 바이너리를 찾을 수 없음

MCP 클라이언트 아래 PATH 문제; 명시적으로 uvx jdocmunch-mcp 사용

대안

JDocMunch MCP 다른 것과 비교

대안	언제 쓰나	단점/장점
Context7	큐레이션된 라이브러리 문서 표면 — 알려진 카탈로그	인덱싱된 라이브러리로만 제한
GitMCP	레포-문서 (README + /docs)	GitMCP는 대형 문서 사이트를 구조화 인덱싱하지 않음