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 與儲存庫資訊。

將此徽章加入你的 README

Featured on YunoDB 徽章樣式與說明

你是這個專案的維護者嗎?展示它已收錄於 YunoDB。

Markdown[![Featured on YunoDB](https://yunodb.com/badge/jgravellejdocmunch-mcp.svg)](https://yunodb.com/tools/jgravellejdocmunch-mcp?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/jgravellejdocmunch-mcp?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/jgravellejdocmunch-mcp.svg" alt="Featured on YunoDB" height="20"></a>