作者 jgravelle · jgravelle/jdocmunch-mcp
不會淹沒你的上下文的文件檢索——結構化章節索引讓 Claude 只拉取它需要的章節。
JDocMunch 是一個針對 token 效率優化的文件 MCP。它將文件預先索引為可瀏覽的章節樹（目錄 + 錨點），讓 Claude 可以拉取單一章節、追蹤交叉引用，且永遠不會傾印 50KB 不相關的參考資料。專為解決「我在讀 AWS SDK 文件，Claude 一直把整頁都抓回來」的問題而設計。
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"jdocmunch-mcp": {
"command": "uvx",
"args": [
"jdocmunch-mcp"
]
}
}
}開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。
{
"mcpServers": {
"jdocmunch-mcp": {
"command": "uvx",
"args": [
"jdocmunch-mcp"
]
}
}
}Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。
{
"mcpServers": {
"jdocmunch-mcp": {
"command": "uvx",
"args": [
"jdocmunch-mcp"
]
}
}
}點擊 Cline 側欄中的 MCP Servers 圖示，然後選 "Edit Configuration"。
{
"mcpServers": {
"jdocmunch-mcp": {
"command": "uvx",
"args": [
"jdocmunch-mcp"
]
}
}
}格式與 Claude Desktop 相同。重啟 Windsurf 生效。
{
"mcpServers": [
{
"name": "jdocmunch-mcp",
"command": "uvx",
"args": [
"jdocmunch-mcp"
]
}
]
}Continue 使用伺服器物件陣列，而非映射。
{
"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 移除。
何時使用： AWS SDK 文件有 200 頁，Claude 想把它們全部抓回來。
結果： 用 2k token 取得答案，而非 80k。
何時使用： 從 v3 遷移到 v4；你想知道什麼地方有精確的變化。
結果： 從文件本身建立的遷移指南。
| 工具 | 輸入參數 | 何時呼叫 | 成本 |
|---|---|---|---|
| index | url_or_path | 第一次使用某份文件集 | 1 次抓取 + 解析 |
| list_sections | doc_id, depth? | 目錄導覽 | 免費（已快取） |
| get_section | doc_id, section_path | 拉取單一章節 | 免費（已快取） |
| follow_link | doc_id, from_section, link_target | 追蹤交叉引用 | 免費（已快取） |
索引用的對外 HTTP在無存取控制的情況下索引私有內部文件在 JavaScript 渲染的文件站點上索引解析失敗部分站點需要 headless 瀏覽器；確認是否有靜態匯出版本
重新索引後章節遺失文件結構已更改；清除快取並重新索引
uvx 找不到執行檔MCP 客戶端下的 PATH 問題；使用明確的 uvx jdocmunch-mcp
| 替代方案 | 何時用它替代 | 權衡 |
|---|---|---|
| Context7 | 精選的函式庫文件已在目錄中 | 僅限已索引的函式庫 |
| GitMCP | 以 repo 作為文件（README + /docs） | GitMCP 不會結構化索引大型文件站 |