Context7 MCP — Cas d'usage, Installer & Démo en direct

Pourquoi l'utiliser

Fonctionnalités clés

Documents frais et épinglés pour plus de 30000 bibliothèques JS/TS/Python/Rust/Go
Deux outils seulement — resolve-library-id + query-docs — zéro surcharge cognitive
Niveau gratuit, clé API gratuite en option pour des limites de taux plus élevées
Fonctionne dans Claude Desktop, Cursor, Windsurf, Zed, Continue, Claude Code, VS Code
Tire les documents pour la version que vous utilisez réellement, pas ce qui est dans la coupe d'entraînement 2024 du modèle

Démo en direct

Aperçu en pratique

context7.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": {
    "context7": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/context7-mcp@latest"
      ]
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/context7-mcp@latest"
      ]
    }
  }
}

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": {
    "context7": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/context7-mcp@latest"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/context7-mcp@latest"
      ]
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "context7",
      "command": "npx",
      "args": [
        "-y",
        "@upstash/context7-mcp@latest"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "context7": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@upstash/context7-mcp@latest"
        ]
      }
    }
  }
}

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

claude mcp add context7 -- npx -y @upstash/context7-mcp@latest

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

Cas d'usage

Usages concrets : Context7

Empêchez votre agent d'halluciner des fonctions qui n'existent pas

👤 Toute personne utilisant un assistant de codage IA avec une bibliothèque plus récente que le seuil de modèle ⏱ ~5 min beginner

Quand l'utiliser : Vous travaillez avec Next.js 15, Prisma 5, Drizzle, LangChain 0.3 ou n'importe quelle bibliothèque en évolution rapide et votre agent continue d'inventer des fonctions qui n'existent pas.

Prérequis

Nœud 18+ — node -v
Contexte7 MCP installé — Collez le bloc de configuration ci-dessus dans vos paramètres Claude Desktop / Cursor / Windsurf

Déroulement

Nommez explicitement la bibliothèque

À l'aide de Context7, tirez les derniers documents pour prisma et montrez-moi la bonne façon de faire une transaction avec des écritures de relations imbriquées.✓ Copié

→ L'agent appelle resolve-library-id puis query-docs avec une requête pertinente, pas un résumé de style Wikipedia
Épingler sur une version si cela compte

Je suis au [email protected]. Utilisez Context7 pour obtenir les documents en streaming App Router pour cette version exacte.✓ Copié

→ La citation inclut la version ; le code utilise des conventions basées sur des fichiers, pas getServerSideProps
Vérifiez votre propre code

Lisez les importations dans src/lib/db.ts, puis utilisez Context7 pour vérifier que chaque fonction que j'ai importée existe réellement dans drizzle-orm 0.30.x.✓ Copié

→ Per-import ✓/✗report with doc links

Résultat : La sortie de l'agent utilise des API réelles et actuelles — premier essai — au lieu de celles inventées d'apparence plausible.

Pièges

L'agent oublie d'appeler Context7 au deuxième tour — Mettez « Toujours utiliser Context7 pour les questions de bibliothèque » dans votre invite système ou CLAUDE.md
Nom de bibliothèque ambigu (par exemple, « supabase ») — Laissez resolve-library-id retourner les correspondances ; choisissez le paquet spécifique (supabase-js vs @supabase/ssr)

Combiner avec : filesystem · github

Échafaudage d'une nouvelle fonctionnalité en utilisant le modèle idiomatique actuel

👤 Ingénieurs démarrant une fonctionnalité dans une version inconnue ou plus récente d'un framework ⏱ ~15 min intermediate

Quand l'utiliser : Vous devez ajouter auth à une application Next.js 15 et souhaitez ignorer les articles de blog obsolètes.

Prérequis

Cadre cible identifié — package.json ou pyproject.toml le répertorie déjà

Déroulement

Demander les idiomes actuels

À l'aide de Context7, récupérez les documents NextAuth v5 et créez une configuration de fournisseur d'informations d'identification pour moi. Je veux la version bêta actuelle, pas la v4.✓ Copié

→ Le code utilise la fonction auth() et la configuration compatible Edge de la v5, et non de la v4 getServerSession
Vérifier les notes de migration

Tirez la section « Mise à niveau à partir de la v4 » des documents NextAuth et indiquez ce que je dois modifier dans mon code actuel.✓ Copié

→ Liste des changements de rupture de style Diff

Résultat : Code v5 fonctionnel lors de la première validation — pas un hybride à moitié migré.

Pièges

Les documents ne couvrent pas votre coque de bord — Context7 n'est disponible que pour les documents ; pour les comportements non publiés, repassez à la source via GitHub MCP

Combiner avec : github · filesystem

Passez en revue une RP avec de vraies citations de documents, pas des vibrations

👤 Évaluateurs qui souhaitent étayer leurs commentaires par des preuves ⏱ ~20 min intermediate

Quand l'utiliser : Passer en revue une RP qui utilise une API de bibliothèque dont vous n'êtes pas sûr à 100 % qu'elle est correcte.

Déroulement

Lire le diff

Retirez le diff du PR #482. Pour chaque appel de bibliothèque, utilisez Context7 pour vérifier la signature et signaler tout ce qui vous semble anormal.✓ Copié

→ Verdict par appel avec lien doc et version
Rédiger des commentaires pouvant être cités

Pour chaque appel signalé, rédigez un commentaire de révision qui relie le document officiel via Context7.✓ Copié

→ Les commentaires se lisent comme « selon les documents de la v15<link>, X devrait être Y »

Résultat : Passez en revue les commentaires avec des citations, pas des opinions.

Combiner avec : github

Migrer une base de code vers une nouvelle version majeure d'une bibliothèque

👤 Ingénieurs effectuant une mise à niveau majeure (React 18→19, Tailwind 3→4, etc.) ⏱ ~90 min advanced

Quand l'utiliser : Vous supprimez une version majeure et le guide de mise à niveau contient 40 pages de « ça dépend ».

Prérequis

Version cible choisie — Choisissez la version exacte ; ne faites pas « dernier » sur les majors

Déroulement

Tirez le guide de migration

Utilisez Context7 pour récupérer le document de migration Tailwind v3 → v4. Résumez sous forme de liste de contrôle.✓ Copié

→ Liste de contrôle ordonnée des modifications importantes
Scannez le dépôt pour chaque problème

Pour chaque élément de cette liste de contrôle, utilisez le système de fichiers MCP pour trouver les modèles correspondants dans src/. Donnez-moi un rapport par dossier.✓ Copié

→ Modèle → liste des fichiers concernés
Patch en petits commits

Faites de chaque élément de migration un commit distinct avec un message faisant référence à la section doc.✓ Copié

→ Nettoyer le journal de validation, vous pouvez revenir élément par élément

Résultat : Une RP de migration que vous pouvez réellement consulter, chaque modification étant liée à une section doc.

Pièges

Prendre trop d'éléments dans un seul commit — Un changement radical → un commit ; facilite la coupe en deux si quelque chose se brise

Combiner avec : filesystem · git · github

Combinaisons

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

context7 + filesystem

Lisez le package.json pour choisir la version exacte, puis interrogez Context7 pour obtenir les documents correspondants

Lisez package.json, recherchez la version suivante et extrayez les documents correspondants de Context7 for Server Actions.✓ Copié

context7 + github

Pour les PR touchant aux API de bibliothèque, annotez la revue avec des citations de documents

Pour chaque appel d'API dans le PR #482, ajoutez un commentaire de révision citant la documentation Context7.✓ Copié

context7 + sequential-thinking

Planifiez une migration étape par étape avant de toucher au code

Utilisez la pensée séquentielle pour planifier la migration Prisma v4 → v5, en extrayant les preuves documentaires de Context7 à chaque étape.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
resolve-library-id	libraryName: str	Premier appel : lever l'ambiguïté sur le nom de la bibliothèque qui vous intéresse	1 free request
query-docs	libraryId: str, query: str, version?: str	Après solve-library-id - posez la vraie question	1 free request (higher rate limit with API key)

Coût et limites

Coût d'exécution

Quota d'API: Le niveau gratuit est généreux ; la clé API gratuite (context7.com/dashboard) augmente les limites de débit
Tokens par appel: ~ 200 à 2 000 par requête en fonction de la longueur du document
Monétaire: Gratuite
Astuce: Requêtes de portée : « comment utiliser X » est moins cher que « donnez-moi tout sur X » ; le serveur renvoie déjà des extraits ciblés

Sécurité

Permissions, secrets, portée

Stockage des identifiants : Var d'environnement CONTEXT7_API_KEY facultative pour des limites de débit plus élevées

Sortie de données : Les requêtes vont sur api.context7.com ; pas de sortie de code — seuls le nom de la bibliothèque et votre requête sont envoyés

Context7 voit ce que vous demandez, pas votre code. Ne collez pas de source propriétaire dans le champ de requête.

Dépannage

Erreurs courantes et correctifs

Bibliothèque introuvable par solve-library-id

Essayez des noms alternatifs (par exemple « nextjs » contre « next.js » contre « @vercel/next ») ; Index Context7 par alias courants mais pas tous les fork

Vérifier : Check context7.com/browse for the official slug

Les documents semblent obsolètes

Incluez un argument de version explicite ; sans cela, vous obtenez les derniers documents indexés de la bibliothèque, ce qui peut retarder les versions de plusieurs heures

Vérifier : Compare the returned snippet URL to the official docs site

Limite de débit atteinte pour l'utilisation anonyme

Obtenez une clé API gratuite sur context7.com/dashboard et définissez CONTEXT7_API_KEY dans le bloc env de votre configuration MCP

Vérifier : Re-run the same query and check it succeeds

Alternatives

Context7 vs autres

Alternative	Quand l'utiliser	Compromis
GitHub MCP (docs folder)	Vous avez besoin d'une vérité au niveau de la source ou d'un comportement inédit	La latence par fichier est élevée ; vous devez naviguer dans le dépôt manuellement
Ref Tools	Vous souhaitez un autre fournisseur de documents avec son propre index	Couverture de bibliothèque différente
Direct web fetch	Le document ne figure dans aucun index : vous avez l'URL	Aucune résolution de version ; vous faites le travail de l'URL

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills