/ Каталог / Песочница / JDocMunch MCP
● Сообщество jgravelle ⚡ Сразу

JDocMunch MCP

автор jgravelle · jgravelle/jdocmunch-mcp

Извлечение документации, не засоряющее контекст — структурированный индекс разделов позволяет Claude тянуть только нужный раздел.

JDocMunch — MCP для документации, оптимизированный по токенам. Предварительно индексирует документацию в навигируемое дерево разделов (TOC + якоря), так что Claude может получить один раздел, перейти по перекрёстным ссылкам и никогда не дампить 50 КБ несвязанного справочного материала. Решает проблему: «Я читаю AWS SDK docs, а 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 использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "jdocmunch-mcp": {
      "command": "uvx",
      "args": [
        "jdocmunch-mcp"
      ]
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "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 использует массив объектов серверов, а не map.

~/.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-справки с большого сайта документации

👤 Разработчики, работающие с cloud SDK ⏱ ~10 min beginner

Когда использовать: Документация AWS SDK занимает 200 страниц, а Claude хочет скачать их все.

Предварительные требования
  • URL документации или локальное дерево — Первый вызов: проиндексируйте документ; последующие попадут в кэш
Поток
  1. Индексация
    Use jdocmunch. Index the AWS S3 SDK docs at the URL. Show me top-level sections.✓ Скопировано
    → Возвращено дерево TOC без полного содержимого
  2. Углубление
    Show only the section on multipart upload — code samples included, intro skipped.✓ Скопировано
    → Содержимое целевого раздела
  3. Переход по ссылке
    Now follow the link to 'Aborting incomplete uploads' from that section.✓ Скопировано
    → Связанный раздел получен

Итог: Ответ за 2k токенов вместо 80k.

Подводные камни
  • Структура документации использует странные якоря (только PDF) — Предварительно конвертируйте в Markdown; jdocmunch лучше всего парсит Markdown
Сочетать с: filesystem

Сравнить разделы документации API между двумя версиями SDK

👤 Разработчики, обновляющие зависимости ⏱ ~20 min intermediate

Когда использовать: Переходите с v3 на v4; нужен точный diff изменений.

Поток
  1. Проиндексировать оба
    Index doc-v3 and doc-v4. List sections that exist only in v4 or have changed.✓ Скопировано
    → Список различий в разделах
  2. Углубиться в изменённые
    Show changes in the 'Authentication' section between v3 and v4.✓ Скопировано
    → Diff по разделу

Итог: Руководство по миграции, построенное из самой документации.

Подводные камни
  • ID разделов меняются между версиями — Сопоставляйте по тексту заголовков, а не по якорям

Комбинации

Сочетайте с другими MCP — эффект x10

jdocmunch-mcp + filesystem

Сохранять полученные разделы в заметки проекта

Pull the multipart-upload section and save it to /docs/notes/s3-multipart.md.✓ Скопировано
jdocmunch-mcp + git-mcp-idosal

Совмещать документацию с исходным кодом первоисточника

Read the doc section, then GitMCP the actual SDK source for that method.✓ Скопировано

Инструменты

Что предоставляет этот MCP

ИнструментВходные данныеКогда вызыватьСтоимость
index url_or_path Первый раз для набора документации 1 fetch + parse
list_sections doc_id, depth? Навигация по TOC free (cached)
get_section doc_id, section_path Получить один раздел free (cached)
follow_link doc_id, from_section, link_target Следовать по перекрёстным ссылкам free (cached)

Стоимость и лимиты

Во что обходится

Квота API
По политике robots.txt хоста
Токенов на вызов
100–800 при структурированном извлечении
Деньги
Бесплатно
Совет
Проиндексируйте один раз, делайте много запросов — кэш делает последующие запросы дёшевыми

Безопасность

Права, секреты, радиус поражения

Минимальные скоупы: Outbound HTTP for indexing
Хранение учётных данных: Нет для публичной документации
Исходящий трафик: Только хост документации, который вы индексируете
Никогда не давайте: Indexing of private internal docs without auth control

Устранение неполадок

Частые ошибки и исправления

Index parse fails on JS-heavy doc site

Некоторые сайты требуют headless-браузер; проверьте, есть ли статический экспорт

Sections missing after re-index

Структура документации изменилась; сбросьте кэш и переиндексируйте

uvx can't find binary

Проблема с PATH под MCP-клиентом; используйте явный путь uvx jdocmunch-mcp

Альтернативы

JDocMunch MCP в сравнении

АльтернативаКогда использоватьКомпромисс
Context7Кураторская документация библиотек — известный каталогОграничен проиндексированными библиотеками
GitMCPРепозиторий как документация (README + /docs)GitMCP не строит структурный индекс больших сайтов документации

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills