Context7 MCP

Problème : Les données d'entraînement d'un modèle ont une date de coupure. Demande quelque chose sur React 19, Next.js 15, ou n'importe quelle bibliothèque qui a sorti une version majeure ces derniers mois, et la réponse revient fausse. Patterns obsolètes. API inventées. Fonctions renommées deux versions plus tôt.

Gain immédiat : Ajoute Context7 à ta config MCP et suffixe n'importe quel prompt avec use context7. La doc est récupérée avant qu'une seule ligne de code soit écrite.

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

Ce qu'est vraiment Context7 MCP

Voilà le résumé court. Context7 est un serveur MCP. Son seul travail : récupérer la documentation actuelle, avec la version précise, directement depuis la source de la bibliothèque, pas depuis un fichier de poids vieux de plusieurs mois.

Le flux est simple. Les docs officielles sont indexées en IDs de bibliothèques. Quand tu nommes une bibliothèque dans un prompt, le serveur résout le nom, récupère les bonnes sections, et glisse ce contenu dans la conversation avant que le modèle réponde.

Pourquoi c'est important pour Claude Code

Les API hallucinées sont la douleur centrale. Les modèles suggèrent des fonctions qui ont été renommées, dépréciées, ou qui n'ont jamais existé. La cause est toujours la même : les données d'entraînement sont en retard sur le calendrier de sortie réel.

Avec ce serveur chargé, tu obtiens :

• La doc au moment de la requête plutôt que ce qui a été livré dans les poids
• Des exemples versionnés liés à la release nommée dans ton prompt
• Des patterns qui fonctionnent tirés des docs officielles et qui compilent du premier coup
• Moins d'hallucinations parce que de vraies API remplacent les inventées

Demande les patterns du routeur d'app Next.js 15. Context7 récupère la doc Next.js 15 sur le moment. Ton code revient en référençant ce qui existe aujourd'hui, pas ce qui existait quand Next.js 13 était la dernière version dans le jeu d'entraînement.

Installation et configuration

Node.js 18 ou plus récent est requis. Le package est @upstash/context7-mcp.

Claude Code CLI

Une commande fait généralement l'affaire :

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

Ou colle-le directement dans .mcp.json à la racine du projet :

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

Claude Desktop

Les utilisateurs macOS doivent éditer ~/Library/Application Support/Claude/claude_desktop_config.json :

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

Le fichier équivalent sur Windows se trouve à %APPDATA%\Claude\claude_desktop_config.json.

Alternative : Runtime Bun

Tu utilises Bun ? Change la commande :

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

Redémarre Claude Code une fois la config en place.

Utilisation en pratique

Deux outils sont livrés avec le serveur :

resolve-library-id : Mappe un nom de bibliothèque simple vers un identifiant compatible Context7. Claude l'utilise chaque fois qu'une bibliothèque est mentionnée par son nom.

query-docs : Récupère les vraies docs pour une bibliothèque. Tu récupères la documentation actuelle, des exemples et des références d'API.

Utilisation de base

Colle use context7 sur n'importe quel prompt qui a besoin de docs fraîches :

Create a Next.js 15 middleware that handles authentication. use context7

Trois choses se passent :

1. Le nom "Next.js" se résout vers l'ID de bibliothèque /vercel/next.js
2. La doc sur le middleware revient d'une requête
3. Le code est écrit selon les formes d'API actuelles

Requêtes spécifiques à une version

Un numéro de version glissé dans le prompt est récupéré automatiquement :

How do I configure Prisma 6 with PostgreSQL? use context7

La documentation retournée correspondra à la release exacte nommée.

IDs de bibliothèques courants

Le format d'ID est /organisation/dépôt. Huit que tu croiseras souvent :

Évite la résolution entièrement en passant l'ID toi-même :

use library /supabase/supabase for API and docs

Bibliothèques supportées

Des milliers de bibliothèques vivent dans l'index. Les principales catégories :

Frontend : React, Vue, Svelte, Angular, Solid, Qwik

Meta-frameworks : Next.js, Nuxt, SvelteKit, Astro, Remix

Backend : Express, Fastify, Hono, NestJS, Koa

Bases de données : Prisma, Drizzle, Mongoose, TypeORM, Supabase

Utilitaires : Zod, tRPC, React Query, SWR, Zustand, Jotai

Tests : Vitest, Jest, Playwright, Cypress

N'importe quelle bibliothèque avec des docs publiques est probablement couverte. Les nouvelles versions sont récupérées en continu.

Association avec MCP Tool Search

MCP Tool Search s'associe proprement avec ce serveur. Active-le et les outils ne se chargent que quand la conversation les demande, ce qui garde le démarrage de session léger.

Pourquoi ça compte : tu peux empiler ce serveur avec d'autres serveurs MCP sans tomber sur des limites de contexte :

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": { "BRAVE_API_KEY": "your-key" }
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "your-token" }
    }
  }
}

Le serveur ne se réveille que quand les docs apparaissent dans le prompt ou que la phrase déclencheur s'affiche. En veille, ça coûte zéro token.

Résolution de problèmes

ERR_MODULE_NOT_FOUND : Remplace npx par bunx. Certains environnements trébuchent sur la couche de cache de npm.

Bibliothèque introuvable : Tout le monde n'est pas indexé. Le serveur te dit clairement quand il ne peut pas résoudre un nom. Utilise un MCP de recherche web comme solution de repli.

Résultats obsolètes : L'indexation tourne sur un calendrier. Les versions des derniers jours peuvent ne pas encore être là. Pour les fonctionnalités de pointe, lis directement les docs officielles.

Prochaines étapes

Un serveur comme celui-ci transforme Claude Code d'un instantané fixe en quelque chose qui fait de la recherche active. Empile-le avec d'autres pour un setup plus complet :

• Lis les fondamentaux MCP si le protocole est encore nouveau pour toi
• Parcours un catalogue de 50+ serveurs MCP pour plus de capacités
• Ajoute un MCP de recherche web pour la recherche au-delà des bibliothèques
• Active MCP Tool Search pour garder l'utilisation du contexte serrée

Connecte Context7 et les patterns dépréciés s'arrêtent. use context7 devient un réflexe dès la première fois que la différence de qualité du code se ressent.