MCP · MCP Spotlight

Serveur MCP Context7 : fournir à l'assistant la documentation à jour des bibliothèques

Context7, édité par Upstash, envoie à un assistant de code la documentation correspondant à la version d'une bibliothèque, pour limiter le code écrit d'après des connaissances périmées. Le serveur est hébergé et ne compte que deux outils. Installation, limites et réserves, d'après le dépôt du projet.

Par Kayzen AI · · 3 min de lecture

Photo d'illustration : Bologna, Museo internazionale e biblioteca della musica (2)
Image : Bologna, Museo internazionale e biblioteca della musica (2) — Palickap, CC BY-SA 4.0, via Wikimedia Commons

Un modèle d'IA connaît les bibliothèques logicielles telles qu'elles existaient au moment de son entraînement. Quand une bibliothèque a changé depuis, il propose du code qui ne fonctionne plus. Context7 répond à ce problème précis : il fournit à l'assistant de la documentation et des exemples de code tirés des sources des bibliothèques, pour la version demandée.

Le projet existe sous deux formes : un serveur MCP, et une commande ctx7 accompagnée d'une « skill », qui se passe de MCP.

Deux outils seulement

Le serveur MCP expose deux outils :

  • resolve-library-id retrouve l'identifiant d'une bibliothèque à partir de son nom ;
  • query-docs renvoie la documentation correspondant à une question, pour un identifiant donné. Un paramètre facultatif language fait remonter en priorité les exemples dans un langage.

Les identifiants ont la forme /vercel/next.js. Le README indique qu'on peut en citer un directement dans sa demande pour sauter l'étape de recherche, et préciser une version pour obtenir la documentation correspondante.

Installation

Le serveur est hébergé à l'adresse https://mcp.context7.com/mcp. La documentation donne cette commande pour Claude Code :

claude mcp add --scope user --header "Authorization: Bearer YOUR_API_KEY" --transport http context7 https://mcp.context7.com/mcp

Dans Cursor, la même adresse se déclare dans ~/.cursor/mcp.json :

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Une version locale existe aussi, avec le paquet npm @upstash/context7-mcp :

claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY

Autre voie, l'installation guidée npx ctx7 setup : elle authentifie l'utilisateur par OAuth, génère une clé et installe la skill. Les options --cursor, --claude et --opencode ciblent un assistant précis. La commande ctx7 demande Node.js 22.13 ou plus récent. Pour tout retirer : npx ctx7 remove.

La clé d'API

Le README recommande une clé gratuite, à créer depuis le tableau de bord de context7.com, pour bénéficier de limites de débit plus élevées. Il ne chiffre pas ces limites, et ne décrit aucune offre payante. La documentation mentionne aussi un point d'accès /mcp/oauth pour s'authentifier par OAuth plutôt que par clé.

Limites et sécurité

  • Le contenu est communautaire. Les fiches de bibliothèques sont proposées par la communauté et maintenues par leurs auteurs, pas par Context7. L'éditeur écrit qu'il ne peut garantir ni l'exactitude, ni l'exhaustivité, ni la sécurité de cette documentation, et que l'usage se fait aux risques de l'utilisateur. Un bouton permet de signaler un contenu suspect.
  • Le service n'est pas entièrement ouvert. Le dépôt, sous licence MIT, ne contient que le code du serveur MCP. Le service qui collecte et analyse la documentation est privé : on dépend donc de sa disponibilité.
  • La liste des bibliothèques couvertes n'est pas donnée dans le README, qui renvoie à un guide pour en ajouter.

Le premier point mérite attention. Le texte renvoyé par Context7 arrive directement dans le contexte de l'assistant, qui s'en sert pour écrire du code. Une fiche erronée ou malveillante peut donc orienter ce code. Par ailleurs, chaque question est envoyée à un service tiers : mieux vaut ne pas y glisser de détails confidentiels sur un projet.

Notre lecture

Context7 traite un défaut que tout utilisateur d'assistant de code a rencontré : la fonction qui n'existe plus, l'option renommée. Le serveur est léger, deux outils seulement, et s'installe en une commande.

Notre conseil : utilisez-le pour les bibliothèques connues et activement maintenues, en précisant la version dans la demande. Pour une bibliothèque confidentielle ou peu répandue, vérifiez d'où vient la fiche avant de vous y fier, et relisez le code produit comme d'habitude. Cette fiche repose sur la documentation du projet ; nous n'avons pas testé le serveur.

Sources

  1. Upstash — upstash/context7 (README) — source primaire
  2. Context7 — installation pour tous les clients