jdocmunch-mcp
AI 代理的文件擷取:只抓取你需要的章節,而非整份文件。支援 Markdown、RST、AsciiDoc、Jupyter、HTML、OpenAPI 等格式。在本機執行,
jdocmunch-mcp 是什麼?
AI 代理的文件擷取:只抓取你需要的章節,而非整份文件。支援 Markdown、RST、AsciiDoc、Jupyter、HTML、OpenAPI 等格式。在本機執行,可搭配 Claude Code 及任何 MCP 用戶端使用。非商業用途免費;商業用途需一次性授權。
jdocmunch-mcp 概覽
這是什麼
jDocMunch 是一個 MCP 伺服器,專為程式碼代理(coding agent)設計,能擷取任務所需的確切文件章節,而不需將整個檔案載入上下文視窗。它會根據標題層級一次索引整個文件集,然後從原始檔案中精確按位元組偏移量提取單一章節、標題子樹或排序後的搜尋結果。它在本地執行,可與 Claude Code 及任何 MCP 客戶端搭配使用。
主要功能
- 以章節為優先的檢索:依章節搜尋與擷取文件,而非僅依檔案路徑或關鍵字比對。
- 位元組精確提取:依需求從原始檔案的確切位元組偏移量提取完整內容。
- 穩定的章節 ID:只要路徑、標題文字與標題層級不變,章節在重新索引後仍保有持久識別碼。
- 品質閘門:每次發行都會對凍結的黃金資料集執行重播測試,若 nDCG 低於 0.95 則視為失敗。
- 支援多種文件格式:Markdown、RST、AsciiDoc、Jupyter、HTML、OpenAPI 等。
- 可選的掃描 PDF OCR 支援(需機器上已安裝 OCR 引擎)。
使用情境
- AI 程式碼代理需要擷取特定文件章節(例如「如何設定驗證」)而不載入整個檔案。
- 減少上下文視窗浪費,僅提取相關的標題子樹或排序後的搜尋結果。
- 可與任何 MCP 相容客戶端(包括 Claude Code)搭配使用。
快速開始
需求:Python 3.10+ 及任何 MCP 相容客戶端。 使用 uv 安裝: bash uv tool install jdocmunch-mcp jdocmunch-mcp init 其他安裝方式: bash uvx jdocmunch-mcp pipx install jdocmunch-mcp pip install jdocmunch-mcp 驗證: bash jdocmunch-mcp --version 手動設定 Claude Code: bash claude mcp add -s user jdocmunch -- uvx jdocmunch-mcp 快速開始 – 索引本機文件資料夾: bash jdocmunch-mcp index-local --path ./docs 然後在代理中使用 search_sections 與 get_section 來擷取特定章節。
授權與價格
授權條款未明確標示(NOASSERTION)。本專案供個人使用免費。商業使用需付費的一次性授權。
內容整理自該專案公開的 README 與儲存庫資訊。