jDocmunch MCP — MCP-сервер для Claude Code: поиск по разделам
Отдаёт агенту только нужный раздел документации вместо целого файла. Полезен, когда справочники большие и контекст забивается лишним.
claude mcp add jdocmunch-mcp -- uvx jdocmunch-mcpЧто делает jDocmunch MCP
jDocmunch разбирает набор документации на дерево разделов по заголовкам и запоминает смещения байтов каждого раздела в исходном файле. Агент запрашивает один раздел, поддерево заголовка или результат поиска с ранжированием — и получает вырезанный кусок, а не весь документ. Идентификаторы разделов остаются прежними при повторной индексации, пока не менялись путь, текст заголовка и его уровень.
Ставится как обычный MCP-сервер: uv tool install jdocmunch-mcp, затем jdocmunch-mcp init. Команда init находит установленные MCP-клиенты, прописывает их конфиги, добавляет политику использования инструментов при исследовании документации и по желанию ставит хуки и индексирует документы. Нужен Python 3.10+ и любой клиент с поддержкой MCP. Хуки запускаются из подоболочки с урезанным PATH и ищут исполняемый файл по имени — без uv tool install (или pipx/pip) они не заработают.
Индексируется локальная папка командой jdocmunch-mcp index-local --path ./docs. В ответе видно число файлов и разделов; разделов обычно больше, потому что индекс адресует заголовки, а не файлы. Установка сама по себе не отучит агента читать файлы целиком: привычку меняет строка в CLAUDE.md — вызвать jdocmunch_guide и следовать его указаниям.
Какие задачи решает
- найти нужный раздел в большой документации, не открывая файл целиком
- получить поддерево заголовка по конкретной теме
- проиндексировать папку с документацией и искать по разделам
- сократить контекст при ответе на вопрос по конфигурации
- сохранить ссылки на разделы между переиндексациями
Примеры запросов агенту
- Найди в документации раздел про настройку аутентификации и покажи его
- Проиндексируй папку
./docsи скажи, сколько там разделов - Найди раздел про affinity и покажи только его, без остального файла
Как установить jDocmunch MCP
Командой платформы
claude mcp add jdocmunch-mcp -- uvx jdocmunch-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from jdocmunch-mcp <команда>
Командой платформы
codex mcp add jdocmunch-mcp -- uvx jdocmunch-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from jdocmunch-mcp <команда>
Файл настроек
{
"mcpServers": {
"jdocmunch-mcp": {
"command": "uvx",
"args": [
"jdocmunch-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from jdocmunch-mcp <команда>
Файл настроек
{
"servers": {
"jdocmunch-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"jdocmunch-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from jdocmunch-mcp <команда>
Командой платформы
gemini mcp add jdocmunch-mcp uvx jdocmunch-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from jdocmunch-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о jDocmunch MCP
Как установить jDocmunch MCP в Claude Code?
Сначала uv tool install jdocmunch-mcp, затем jdocmunch-mcp init — команда сама пропишет конфиги найденных MCP-клиентов. Для ручной настройки Claude есть claude mcp add jdocmunch-mcp -- uvx jdocmunch-mcp.
Что делает jDocmunch MCP?
Индексирует документацию по иерархии заголовков и отдаёт агенту отдельный раздел или поддерево, вырезанные из исходного файла по байтовым смещениям.
Что нужно для работы сервера?
Python 3.10+ и MCP-совместимый клиент. Хуки требуют установки через uv tool install, pipx или pip, потому что запускаются из подоболочки с минимальным PATH.
