upstash__context7/i18n/README.it.md

Context7 MCP - Documentazione aggiornata per qualsiasi prompt

❌ 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 >= v18.0.0
• 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

1. Apri il file di configurazione MCP di Copilot CLI. La posizione è ~/.copilot/mcp-config.json (dove ~ è la tua home directory).
2. Aggiungi quanto segue all'oggetto mcpServers nel tuo file mcp-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:

1. Costruisci l'immagine Docker: Prima, crea un Dockerfile nella radice del progetto (o ovunque tu preferisca):

   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"]
   

   Poi, costruisci l'immagine utilizzando un tag (ad esempio, context7-mcp). Assicurati che Docker Desktop (o il demone Docker) sia in esecuzione. Esegui il seguente comando nella stessa directory in cui hai salvato il Dockerfile:

   docker build -t context7-mcp .
   

2. 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:

   {
     "mcpServers": {
       "Сontext7": {
         "autoApprove": [],
         "disabled": false,
         "timeout": 60,
         "command": "docker",
         "args": ["run", "-i", "--rm", "context7-mcp"],
         "transportType": "stdio"
       }
     }
   }
   

   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 vs servers). Inoltre, assicurati che il nome dell'immagine in args corrisponda al tag utilizzato durante il comando docker 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@1.0.6"]
    }
  }
}

Errori del Client MCP

1. Prova a rimuovere @latest dal nome del pacchetto.
2. Prova a usare bunx come alternativa.
3. Prova a usare deno come alternativa.
4. Assicurati di utilizzare Node v18 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