Context7 Platform -- Up-to-date docs for AI agents
Context7 MCP - Documentazione aggiornata per gli agenti IA
❌ Senza Context7
LLMs si affidano a informazioni obsolete o generiche sulle librerie che utilizzi. Ottieni:
- ❌ Gli esempi di codice sono obsoleti e basati su dati di formazione vecchi di anni
- ❌ Le API allucinate non esistono nemmeno
- ❌ Risposte generiche per vecchie versioni del pacchetto
✅ Con Context7
Context7 MCP recupera documentazione aggiornata, specifica per versione e esempi di codice direttamente dalla fonte — e li inserisce direttamente nel tuo prompt.
Aggiungi use context7 al prompt in Cursor:
Crea un progetto Next.js di base con app router. Usa context7
Creare uno script per eliminare le righe in cui la città è "", date le credenziali di PostgreSQL. usare context7
Context7 recupera esempi di codice e documentazione aggiornati direttamente nel contesto del tuo LLM.
- 1️⃣ Scrivi il tuo prompt in modo naturale
- 2️⃣ Indica all'LLM di usare context7
- 3️⃣ Ottieni risposte di codice funzionante Nessun cambio di tab, nessuna API allucinata che non esiste, nessuna generazione di codice obsoleta.
🛠️ Iniziare
Requisiti
- Node.js >= v20.18.1
- Cursor, Devin Desktop, Claude Desktop o un altro client MCP
Installazione tramite Smithery
Per installare Context7 MCP Server per Claude Desktop automaticamente tramite Smithery:
npx -y @smithery/cli install @upstash/context7-mcp --client claude
Installare in Cursor
Vai a: Impostazioni -> Impostazioni cursore -> MCP -> Aggiungi nuovo server MCP globale
Incollare la seguente configurazione nel file ~/.cursor/mcp.json di Cursor è l'approccio consigliato. Vedi Cursor MCP docs per ulteriori informazioni.
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp@latest"]
}
}
}
Alternativa: Usa Bun
{
"mcpServers": {
"context7": {
"command": "bunx",
"args": ["-y", "@upstash/context7-mcp@latest"]
}
}
}
Alternativa: Usa Deno
{
"mcpServers": {
"context7": {
"command": "deno",
"args": ["run", "--allow-net", "npm:@upstash/context7-mcp"]
}
}
}
Installare in Devin Desktop
Aggiungi questo al tuo file di configurazione Devin Desktop MCP. Vedi Devin Desktop MCP docs per ulteriori informazioni.
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp@latest"]
}
}
}
Installare in VS Code
Aggiungi questo al tuo file di configurazione MCP di VS Code. Vedi VS Code MCP docs per ulteriori informazioni.
{
"servers": {
"Context7": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@upstash/context7-mcp@latest"]
}
}
}
Installare in Zed
Può essere installato tramite Zed Extensions oppure puoi aggiungere questo al tuo settings.json di Zed. Vedi Zed Context Server docs per ulteriori informazioni.
{
"context_servers": {
"Context7": {
"source": "custom",
"command": "npx",
"args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
}
}
}
Installare in Claude Code
Esegui questo comando. Vedi Claude Code MCP docs per ulteriori informazioni.
claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp@latest
Installare in Claude Desktop
Aggiungi questo al tuo file claude_desktop_config.json di Claude Desktop. Vedi Claude Desktop MCP docs per ulteriori informazioni.
{
"mcpServers": {
"Context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp@latest"]
}
}
}
Installazione in Copilot Coding Agent
Aggiungi la seguente configurazione alla sezione mcp del file di configurazione di Copilot Coding Agent (Repository->Settings->Copilot->Coding agent->MCP configuration):
{
"mcpServers": {
"context7": {
"type": "http",
"url": "https://mcp.context7.com/mcp",
"tools": ["query-docs", "resolve-library-id"]
}
}
}
Per maggiori informazioni, consulta la documentazione ufficiale GitHub.
Installazione in Copilot CLI
- Apri il file di configurazione MCP di Copilot CLI. La posizione è
~/.copilot/mcp-config.json(dove~è la tua home directory). - Aggiungi quanto segue all'oggetto
mcpServersnel tuo filemcp-config.json:
{
"mcpServers": {
"context7": {
"type": "http",
"url": "https://mcp.context7.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
},
"tools": ["query-docs", "resolve-library-id"]
}
}
}
Oppure, per un server locale:
{
"mcpServers": {
"context7": {
"type": "local",
"command": "npx",
"tools": ["query-docs", "resolve-library-id"],
"args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
}
}
}
Se il file mcp-config.json non esiste, crealo.
Utilizzo di Docker
Se preferisci eseguire il server MCP in un contenitore Docker:
- Costruisci l'immagine Docker:
Prima, crea un
Dockerfilenella radice del progetto (o ovunque tu preferisca):Poi, costruisci l'immagine utilizzando un tag (ad esempio,Clicca per visualizzare il contenuto del Dockerfile
FROM node:18-alpine WORKDIR /app # Installa l ultima versione globalmente RUN npm install -g @upstash/context7-mcp@latest # Esponi la porta predefinita se necessario (opzionale, dipende dall interazione del client MCP) # EXPOSE 3000 # Comando predefinito per eseguire il server CMD ["context7-mcp"]context7-mcp). Assicurati che Docker Desktop (o il demone Docker) sia in esecuzione. Esegui il seguente comando nella stessa directory in cui hai salvato ilDockerfile:docker build -t context7-mcp . - Configura il tuo client MCP:
Aggiorna la configurazione del tuo client MCP per utilizzare il comando Docker.
Esempio per un file cline_mcp_settings.json:
Nota: Questa è una configurazione di esempio. Consulta gli esempi specifici per il tuo client MCP (come Cursor, VS Code, ecc.) precedentemente in questo README per adattare la struttura (ad es.,{ "mcpServers": { "Сontext7": { "autoApprove": [], "disabled": false, "timeout": 60, "command": "docker", "args": ["run", "-i", "--rm", "context7-mcp"], "transportType": "stdio" } } }mcpServersvsservers). Inoltre, assicurati che il nome dell'immagine inargscorrisponda al tag utilizzato durante il comandodocker build.
Strumenti Disponibili
resolve-library-id: Converte un nome generico di libreria in un ID di libreria compatibile con Context7.query(obbligatorio): La domanda o il compito dell'utente (per il ranking di rilevanza)libraryName(obbligatorio): Il nome della libreria da cercare
query-docs: Recupera la documentazione per una libreria utilizzando un ID di libreria compatibile con Context7.libraryId(obbligatorio): ID esatto compatibile con Context7 (ad esempio,/mongodb/docs,/vercel/next.js)query(obbligatorio): La domanda o il compito per ottenere documentazione pertinente
Sviluppo
Clona il progetto e installa le dipendenze:
pnpm i
Compila:
pnpm run build
Esempio di Configurazione Locale
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["tsx", "/path/to/folder/context7-mcp/src/index.ts"]
}
}
}
Test con MCP Inspector
npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp@latest
Risoluzione dei problemi
ERR_MODULE_NOT_FOUND
Se vedi questo errore, prova a usare bunx invece di npx.
{
"mcpServers": {
"context7": {
"command": "bunx",
"args": ["-y", "@upstash/context7-mcp@latest"]
}
}
}
Questo spesso risolve i problemi di risoluzione dei moduli, specialmente negli ambienti dove npx non installa o risolve correttamente i pacchetti.
Problemi di risoluzione ESM
Se riscontri un errore come: Error: Cannot find module 'uriTemplate.js' prova a eseguire con il flag --experimental-vm-modules:
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "--node-options=--experimental-vm-modules", "@upstash/context7-mcp"]
}
}
}
Errori del Client MCP
- Prova a rimuovere
@latestdal nome del pacchetto. - Prova a usare
bunxcome alternativa. - Prova a usare
denocome alternativa. - Assicurati di utilizzare Node v20 o superiore per avere il supporto nativo di fetch con
npx.
Dichiarazione di non responsabilità
I progetti Context7 sono contributi della comunità e, sebbene ci impegniamo a mantenere un'alta qualità, non possiamo garantire l'accuratezza, la completezza o la sicurezza di tutta la documentazione delle librerie. I progetti elencati in Context7 sono sviluppati e gestiti dai rispettivi proprietari, non da Context7. Se riscontri contenuti sospetti, inappropriati o potenzialmente dannosi, utilizza il pulsante "Segnala" sulla pagina del progetto per informarci immediatamente. Prendiamo sul serio tutte le segnalazioni e esamineremo prontamente i contenuti segnalati per mantenere l'integrità e la sicurezza della nostra piattaforma. Utilizzando Context7, riconosci di farlo a tua discrezione e a tuo rischio.
Context7 nei Media
- Better Stack: "Free Tool Makes Cursor 10x Smarter"
- Cole Medin: "This is Hands Down the BEST MCP Server for AI Coding Assistants"
- Income stream surfers: "Context7 + SequentialThinking MCPs: Is This AGI?"
- Julian Goldie SEO: "Context7: New MCP AI Agent Update"
- JeredBlu: "Context 7 MCP: Get Documentation Instantly + VS Code Setup"
- Income stream surfers: "Context7: The New MCP Server That Will CHANGE AI Coding"
Licenza
MIT