/ Annuaire / Playground / JDocMunch MCP
● Communauté jgravelle ⚡ Instantané

JDocMunch MCP

par jgravelle · jgravelle/jdocmunch-mcp

Récupération de documentation qui ne noie pas votre contexte — un index de sections structuré permet à Claude de tirer uniquement la section dont il a besoin.

JDocMunch est un MCP de documentation optimisé pour l'efficacité en tokens. Il pré-indexe la documentation dans un arbre de sections navigable (TOC + ancres), afin que Claude puisse extraire une seule section, suivre les références croisées, et ne jamais dumper 50 Ko de matériel de référence non pertinent. Conçu pour le problème « je lis la doc du SDK AWS et Claude récupère toujours la page entière ».

Pourquoi l'utiliser

Fonctionnalités clés

Démo en direct

Aperçu en pratique

jdocmunch-mcp.replay ▶ prêt
0/0

Installer

Choisissez votre client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "jdocmunch-mcp": {
      "command": "uvx",
      "args": [
        "jdocmunch-mcp"
      ]
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "jdocmunch-mcp": {
      "command": "uvx",
      "args": [
        "jdocmunch-mcp"
      ]
    }
  }
}

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

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

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "jdocmunch-mcp": {
      "command": "uvx",
      "args": [
        "jdocmunch-mcp"
      ]
    }
  }
}

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "jdocmunch-mcp",
      "command": "uvx",
      "args": [
        "jdocmunch-mcp"
      ]
    }
  ]
}

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json
{
  "context_servers": {
    "jdocmunch-mcp": {
      "command": {
        "path": "uvx",
        "args": [
          "jdocmunch-mcp"
        ]
      }
    }
  }
}

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

claude mcp add jdocmunch-mcp -- uvx jdocmunch-mcp

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : JDocMunch MCP

Extraire uniquement la section de référence API dont vous avez besoin depuis un site de doc géant

👤 Devs travaillant avec des SDK cloud ⏱ ~10 min beginner

Quand l'utiliser : La doc du SDK AWS fait 200 pages et Claude veut toutes les récupérer.

Prérequis
  • URL de doc ou arborescence de doc locale — Premier appel : indexer la doc ; les appels suivants frappent le cache
Déroulement
  1. Indexer
    Utilise jdocmunch. Indexe la doc du SDK AWS S3 à l'URL. Montre-moi les sections de niveau supérieur.✓ Copié
    → Arbre TOC retourné, pas encore de contenu complet
  2. Forer
    Montre uniquement la section sur l'upload multipart — exemples de code inclus, introduction ignorée.✓ Copié
    → Contenu de la section ciblée
  3. Suivre
    Suis maintenant le lien vers 'Abandon des uploads incomplets' depuis cette section.✓ Copié
    → Section liée récupérée

Résultat : Réponse en 2k tokens au lieu de 80k.

Pièges
  • La structure du doc a des ancres bizarres (PDF uniquement) — Convertissez d'abord en Markdown ; jdocmunch parse le Markdown au mieux
Combiner avec : filesystem

Comparer les sections de doc API entre deux versions de SDK

👤 Devs mettant à niveau des dépendances ⏱ ~20 min intermediate

Quand l'utiliser : Vous passez de v3 à v4 ; vous voulez un diff précis de ce qui a changé.

Déroulement
  1. Indexer les deux
    Indexe doc-v3 et doc-v4. Liste les sections qui n'existent que dans v4 ou qui ont changé.✓ Copié
    → Liste diff de sections
  2. Forer les modifications
    Montre les changements dans la section 'Authentification' entre v3 et v4.✓ Copié
    → Diff par section

Résultat : Guide de migration construit à partir des docs elles-mêmes.

Pièges
  • Les IDs de section changent entre versions — Faites correspondre par texte d'en-tête plutôt que par ancre

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

jdocmunch-mcp + filesystem

Sauvegarder les sections récupérées dans les notes du projet

Récupère la section multipart-upload et sauvegarde-la dans /docs/notes/s3-multipart.md.✓ Copié
jdocmunch-mcp + git-mcp-idosal

Associer la doc au code source de référence

Lis la section de doc, puis GitMCP le source SDK actuel pour cette méthode.✓ Copié

Outils

Ce que ce MCP expose

OutilEntréesQuand appelerCoût
index url_or_path Première fois sur un ensemble de docs 1 fetch + parse
list_sections doc_id, depth? Navigation dans le TOC gratuit (mis en cache)
get_section doc_id, section_path Récupérer une section gratuit (mis en cache)
follow_link doc_id, from_section, link_target Suivre les références croisées gratuit (mis en cache)

Coût et limites

Coût d'exécution

Quota d'API
Selon la politique robots de l'hôte
Tokens par appel
100–800 avec récupération structurée
Monétaire
Gratuit
Astuce
Indexez une fois, interrogez souvent — le cache rend les suivis peu coûteux

Sécurité

Permissions, secrets, portée

Portées minimales : HTTP sortant pour l'indexation
Stockage des identifiants : Aucun pour les docs publiques
Sortie de données : Vers l'hôte de doc que vous indexez
Ne jamais accorder : Indexation de docs internes privées sans contrôle d'authentification

Dépannage

Erreurs courantes et correctifs

Échec du parsing de l'index sur un site de doc chargé en JS

Certains sites nécessitent un navigateur headless ; vérifiez si un export statique existe

Sections manquantes après ré-indexation

La structure du doc a changé ; videz le cache et ré-indexez

uvx ne trouve pas le binaire

Problème de PATH sous le client MCP ; utilisez uvx jdocmunch-mcp explicitement

Alternatives

JDocMunch MCP vs autres

AlternativeQuand l'utiliserCompromis
Context7Surface de docs de bibliothèques curées — catalogue connuLimité aux bibliothèques indexées
GitMCPDépôt-comme-docs (README + /docs)GitMCP n'indexe pas structurellement les grands sites de doc

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills