/ 目录 / 演练场 / JDocMunch MCP
● 社区 jgravelle ⚡ 即开即用

JDocMunch MCP

作者 jgravelle · jgravelle/jdocmunch-mcp

不会淹没上下文的文档检索——结构化章节索引让 Claude 只拉取它需要的那一节。

JDocMunch 是一个以 token 效率为核心设计的文档 MCP。它将文档预索引为可导航的章节树(目录 + 锚点),Claude 可以只拉取单个章节、追踪交叉引用,而不会把 50KB 不相关的参考资料全部塞进上下文。专为解决「读 AWS SDK 文档时 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 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

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

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "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 使用服务器对象数组,而非映射。

~/.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 参考章节

👤 使用云 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.✓ 已复制
    → 返回目录树,尚无正文内容
  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 token 回答问题,而不是 80k。

注意事项
  • 文档结构有奇怪的锚点(仅 PDF) — 先转换为 Markdown;jdocmunch 对 Markdown 解析效果最好
搭配使用: filesystem

对比两个 SDK 版本的 API 文档章节差异

👤 升级依赖的开发者 ⏱ ~20 min intermediate

何时使用: 你要从 v3 迁移到 v4;需要精确了解发生了哪些变更。

步骤
  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.✓ 已复制
    → 每个章节的具体差异

结果: 直接从文档本身构建的迁移指南。

注意事项
  • 不同版本间章节 ID 发生变化 — 按标题文本匹配,而不是按锚点

组合

与其他 MCP 搭配,撬动十倍杠杆

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? 浏览目录导航 free (cached)
get_section doc_id, section_path 拉取某一章节 free (cached)
follow_link doc_id, from_section, link_target 追踪交叉引用 free (cached)

成本与限制

运行它的成本

API 配额
受各主机 robots 协议约束
每次调用 Token 数
结构化检索后 100-800
费用
免费
提示
索引一次,多次查询——缓存让后续检索几乎零成本

安全

权限、密钥、影响范围

最小权限: Outbound HTTP for indexing
凭据存储: 公开文档无需凭证
数据出站: 取决于你索引的文档主机
切勿授予: Indexing of private internal docs without auth control

故障排查

常见错误与修复

Index parse fails on JS-heavy doc site

部分站点需要无头浏览器;查看是否有静态导出版本

Sections missing after re-index

文档结构已变更;清除缓存后重新建索引

uvx can't find binary

MCP 客户端下的 PATH 问题;使用显式路径 uvx jdocmunch-mcp

替代方案

JDocMunch MCP 对比其他方案

替代方案何时用它替代权衡
Context7精选的库文档表面——已知目录仅限已索引的库
GitMCP以仓库为文档(README + /docs)GitMCP 不会对大型文档站点做结构索引

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills