Docs Fresh (Context7 wrapper)

Declenche l'injection de docs fraiches via le serveur MCP Context7 quand une tache implique une bibliotheque, un framework ou une API externe.

Prerequis

Le serveur MCP Context7 doit etre declare dans .mcp.json du plugin (cf ${CLAUDE_PLUGIN_ROOT}/.mcp.json). Il est inclus par defaut dans ce plugin.

Pour le configurer manuellement en dehors du plugin :

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

Quand declencher

• L'utilisateur mentionne une bibliotheque precise : React, Next.js, Vue, FastAPI, Django, Supabase, Prisma, TanStack Query, Zod, Langchain, Anthropic SDK, etc.
• L'utilisateur demande "comment utiliser X", "l'API de X", "la signature de X"
• Je m'apprete a ecrire du code utilisant une API tiers
• L'utilisateur ecrit explicitement "use context7" dans son prompt

Procedure

1. Resoudre l'ID de la bibliotheque via l'outil MCP resolve-library-id :

   resolve-library-id({ libraryName: "Next.js" })
   

   Retour : /vercel/next.js

2. Recuperer les docs pertinentes via query-docs :

   query-docs({
     libraryId: "/vercel/next.js",
     query: "server actions with form validation"
   })
   

3. Integrer le snippet dans la reponse ou le contexte du sous-agent.

Benefices token

D'apres Upstash, Context7 :

• Reduit le contexte moyen de 65% vs injection massive de docs
• Reduit la latence de 38%
• Elimine les hallucinations d'API (APIs inexistantes, parametres obsoletes)

Bonnes pratiques

• Formuler la requete de facon ciblee : "useEffect cleanup pattern" plutot que "react docs"
• Combiner avec model-router : meme avec docs fraiches, une implementation critique passe par Opus
• Cacher localement : Context7 gere son propre cache cote serveur, ne pas re-requeter dans le meme tour
• Tomber gracieusement : si Context7 est indisponible, prevenir l'utilisateur et proposer la recherche web comme fallback

Exemples de prompts utilisateur qui declenchent ce skill

• "Ecris un hook React pour l'infinite scroll avec TanStack Query" (lib = TanStack Query)
• "Comment configurer RLS dans Supabase ?" (lib = Supabase)
• "use context7 : quelle est la signature actuelle de messages.create() dans le SDK Anthropic ?"
• "Migration Next.js 14 vers 15, quoi checker ?"

References

• Source : https://github.com/upstash/context7
• Blog : https://upstash.com/blog/new-context7
• Package NPM : @upstash/context7-mcp