Context7 Platform -- Up-to-date docs for AI agents
docs: add Italian translation
Raphael Abenom70f7c7ee3566
diff --git a/README.md b/README.mdindex 8db9e1d8..0cbc64e0 100644--- a/README.md+++ b/README.md@@ -2,7 +2,7 @@[](https://context7.com) [](https://smithery.ai/server/@upstash/context7-mcp) [<img alt="Install in VS Code (npx)" src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20Context7%20MCP&color=0098FF">](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%7B%22name%22%3A%22context7%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40upstash%2Fcontext7-mcp%40latest%22%5D%7D)-[](./docs/README.zh-CN.md) [](./docs/README.ko.md) [](./docs/README.es.md) [](./docs/README.fr.md) [-purple)](./docs/README.pt-BR.md)+[](./docs/README.zh-CN.md) [](./docs/README.ko.md) [](./docs/README.es.md) [](./docs/README.fr.md) [-purple)](./docs/README.pt-BR.md) [](./docs/README.it.md)## ❌ Without Context7diff --git a/docs/README.it.md b/docs/README.it.mdnew file mode 100644index 00000000..c02ae4e7--- /dev/null+++ b/docs/README.it.md@@ -0,0 +1,340 @@+# Context7 MCP - Documentazione aggiornata per qualsiasi prompt++[](https://context7.com) [](https://smithery.ai/server/@upstash/context7-mcp) [<img alt="Install in VS Code (npx)" src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Installa%20Context7%20MCP&color=0098FF">](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%7B%22name%22%3A%22context7%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40upstash%2Fcontext7-mcp%40latest%22%5D%7D)++[](./docs/README.zh-CN.md) [](./docs/README.ko.md) [](./docs/README.es.md) [](./docs/README.fr.md) [-purple)](./docs/README.pt-BR.md) [](./docs/README.it.md)+++## ❌ 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:++```txt+Crea un progetto Next.js di base con app router. Usa context7+```++```txt+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, Windsurf, Claude Desktop o un altro client MCP++### Installazione tramite Smithery++Per installare Context7 MCP Server per Claude Desktop automaticamente tramite [Smithery](https://smithery.ai/server/@upstash/context7-mcp):++```bash+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](https://docs.cursor.com/context/model-context-protocol) per ulteriori informazioni.++```json+{+ "mcpServers": {+ "context7": {+ "command": "npx",+ "args": ["-y", "@upstash/context7-mcp@latest"]+ }+ }+}+```++<details>+<summary>Alternativa: Usa Bun</summary>++```json+{+ "mcpServers": {+ "context7": {+ "command": "bunx",+ "args": ["-y", "@upstash/context7-mcp@latest"]+ }+ }+}+```++</details>++<details>+<summary>Alternativa: Usa Deno</summary>++```json+{+ "mcpServers": {+ "context7": {+ "command": "deno",+ "args": ["run", "--allow-net", "npm:@upstash/context7-mcp"]+ }+ }+}+```++</details>++### Installare in Windsurf++Aggiungi questo al tuo file di configurazione Windsurf MCP. Vedi [Windsurf MCP docs](https://docs.windsurf.com/windsurf/mcp) per ulteriori informazioni.++```json+{+ "mcpServers": {+ "context7": {+ "command": "npx",+ "args": ["-y", "@upstash/context7-mcp@latest"]+ }+ }+}+```++### Installare in VS Code++[<img alt="Installa in VS Code (npx)" src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Installa%20Context7%20MCP&color=0098FF">](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%7B%22name%22%3A%22context7%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40upstash%2Fcontext7-mcp%40latest%22%5D%7D)+[<img alt="Installa in VS Code Insiders (npx)" src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Installa%20Context7%20MCP&color=24bfa5">](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%7B%22name%22%3A%22context7%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40upstash%2Fcontext7-mcp%40latest%22%5D%7D)++Aggiungi questo al tuo file di configurazione MCP di VS Code. Vedi [VS Code MCP docs](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) per ulteriori informazioni.++```json+{+ "servers": {+ "Context7": {+ "type": "stdio",+ "command": "npx",+ "args": ["-y", "@upstash/context7-mcp@latest"]+ }+ }+}+```++### Installare in Zed++Può essere installato tramite [Zed Extensions](https://zed.dev/extensions?query=Context7) oppure puoi aggiungere questo al tuo `settings.json` di Zed. Vedi [Zed Context Server docs](https://zed.dev/docs/assistant/context-servers) per ulteriori informazioni.++```json+{+ "context_servers": {+ "Context7": {+ "command": {+ "path": "npx",+ "args": ["-y", "@upstash/context7-mcp@latest"]+ },+ "settings": {}+ }+ }+}+```++### Installare in Claude Code++Esegui questo comando. Vedi [Claude Code MCP docs](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/tutorials#set-up-model-context-protocol-mcp) per ulteriori informazioni.++```sh+claude mcp add 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](https://modelcontextprotocol.io/quickstart/user) per ulteriori informazioni.++```json+{+ "mcpServers": {+ "Context7": {+ "command": "npx",+ "args": ["-y", "@upstash/context7-mcp@latest"]+ }+ }+}+```++### 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):++ <details>+ <summary>Clicca per visualizzare il contenuto del Dockerfile</summary>++ ```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"]+ ```++ </details>++ 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`:++ ```bash+ 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:*++ ```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.+- `libraryName` (obbligatorio)+- `get-library-docs`: Recupera la documentazione per una libreria utilizzando un ID di libreria compatibile con Context7.+- `context7CompatibleLibraryID` (obbligatorio)+- `topic` (opzionale): Concentra la documentazione su un argomento specifico (es., "routing", "hooks")+- `tokens` (opzionale, predefinito 5000): Numero massimo di token da restituire. I valori inferiori a 5000 vengono automaticamente aumentati a 5000.++## Sviluppo++Clona il progetto e installa le dipendenze:++```bash+bun i+```++Compila:++```bash+bun run build+```+### Esempio di Configurazione Locale++```json+{+ "mcpServers": {+ "context7": {+ "command": "npx",+ "args": ["tsx", "/path/to/folder/context7-mcp/src/index.ts"]+ }+ }+}+```++### Test con MCP Inspector++```bash+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`.++```json+{+ "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`:++```json+{+ "mcpServers": {+ "context7": {+ "command": "npx",+ "args": [+ "-y",+ "--node-options=--experimental-vm-modules",+ "@upstash/[email protected]"+ ]+ }+ }+}+```++### 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"](https://youtu.be/52FC3qObp9E)+- [Cole Medin: "This is Hands Down the BEST MCP Server for AI Coding Assistants"](https://www.youtube.com/watch?v=G7gK8H6u7Rs)+- [Income stream surfers: "Context7 + SequentialThinking MCPs: Is This AGI?"](https://www.youtube.com/watch?v=-ggvzyLpK6o)+- [Julian Goldie SEO: "Context7: New MCP AI Agent Update"](https://www.youtube.com/watch?v=CTZm6fBYisc)+- [JeredBlu: "Context 7 MCP: Get Documentation Instantly + VS Code Setup"](https://www.youtube.com/watch?v=-ls0D-rtET4)+- [Income stream surfers: "Context7: The New MCP Server That Will CHANGE AI Coding"](https://www.youtube.com/watch?v=PS-2Azb-C3M)++## Storico delle Stelle++[](https://www.star-history.com/#upstash/context7&Date)++## Licenza++MIT