/ ディレクトリ / プレイグラウンド / JDocMunch MCP
← 全サーバー ↗ GitHub
● コミュニティ 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.✓ コピーしました
    → TOCツリーが返却；フルコンテンツはまだ取得しない
  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.✓ コピーしました
    → リンク先のセクションが取得される

結果： 80k tokenではなく2k tokenで回答が得られる。

注意点
  • ドキュメント構造のアンカーがおかしい（PDF専用など） — 先にMarkdownに変換する；JDocMunchはMarkdownを最もよくパースする
組み合わせ： filesystem

2つのSDKバージョン間でAPIドキュメントのセクションを比較する

👤 依存関係をアップグレードする開発者 ⏱ ~20 min intermediate

使うタイミング： v3からv4に移行する；何が変わったかを正確なdiffで確認したい。

フロー
  1. 両方をインデックス化
    Index doc-v3 and doc-v4. List sections that exist only in v4 or have changed.✓ コピーしました
    → セクションのdiffリスト
  2. 変更箇所を掘り下げ
    Show changes in the 'Authentication' section between v3 and v4.✓ コピーしました
    → セクションごとのdiff

結果： ドキュメント自体から構築されたマイグレーションガイド。

注意点
  • バージョン間でセクションIDが変わる — アンカーではなく見出しテキストでマッチする

組み合わせ

他のMCPと組み合わせて10倍の力を

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回の取得+パース
list_sections doc_id, depth? 目次のナビゲーション 無料（キャッシュ済み）
get_section doc_id, section_path 1つのセクションを取得するとき 無料（キャッシュ済み）
follow_link doc_id, from_section, link_target 相互参照を追跡するとき 無料（キャッシュ済み）

コストと制限

運用コスト

APIクォータ
各ホストのrobots.pyポリシーに依存
呼び出しあたりのトークン
構造化検索で100〜800 token
金額
無料
ヒント
一度インデックス化して複数回クエリ — キャッシュでフォローアップが安価になる

セキュリティ

権限、シークレット、影響範囲

最小スコープ： インデックス化のためのアウトバウンドHTTP
認証情報の保管： 公開ドキュメントでは不要
データ送信先： インデックス化したドキュメントホストに依存
絶対に付与しない： 認証管理なしで社内プライベートドキュメントをインデックス化しない

トラブルシューティング

よくあるエラーと対処法

JS多用のドキュメントサイトでインデックスのパースに失敗

一部のサイトではヘッドレスブラウザが必要；静的エクスポートがないか確認

再インデックス後にセクションが消える

ドキュメント構造が変わった；キャッシュを破棄して再インデックス

uvxがバイナリを見つけられない

MCPクライアント下のPATHの問題；明示的にuvx jdocmunch-mcpを使用

代替案

JDocMunch MCP 他との比較

代替案代わりに使う場面トレードオフ
Context7キュレーション済みライブラリドキュメントが表示される場合 — 既知のカタログインデックス済みライブラリに限定
GitMCPリポジトリをドキュメントとして使う場合（README + /docs）GitMCPは大型ドキュメントサイトの構造インデックスを持たない

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る