From 70f7c7ee35661635b2e36c190b84cae96f76319e Mon Sep 17 00:00:00 2001 From: Raphael Abenom Date: Tue, 29 Apr 2025 02:47:28 -0300 Subject: [PATCH] docs: add Italian translation --- README.md | 2 +- docs/README.it.md | 340 ++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 341 insertions(+), 1 deletion(-) create mode 100644 docs/README.it.md diff --git a/README.md b/README.md index 8db9e1d..0cbc64e 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ [![Website](https://img.shields.io/badge/Website-context7.com-blue)](https://context7.com) [![smithery badge](https://smithery.ai/badge/@upstash/context7-mcp)](https://smithery.ai/server/@upstash/context7-mcp) [Install in VS Code (npx)](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) -[![中文文档](https://img.shields.io/badge/docs-中文版-yellow)](./docs/README.zh-CN.md) [![한국어 문서](https://img.shields.io/badge/docs-한국어-green)](./docs/README.ko.md) [![Documentación en Español](https://img.shields.io/badge/docs-Español-orange)](./docs/README.es.md) [![Documentation en Français](https://img.shields.io/badge/docs-Français-blue)](./docs/README.fr.md) [![Documentação em Português (Brasil)](https://img.shields.io/badge/docs-Português%20(Brasil)-purple)](./docs/README.pt-BR.md) +[![中文文档](https://img.shields.io/badge/docs-中文版-yellow)](./docs/README.zh-CN.md) [![한국어 문서](https://img.shields.io/badge/docs-한국어-green)](./docs/README.ko.md) [![Documentación en Español](https://img.shields.io/badge/docs-Español-orange)](./docs/README.es.md) [![Documentation en Français](https://img.shields.io/badge/docs-Français-blue)](./docs/README.fr.md) [![Documentação em Português (Brasil)](https://img.shields.io/badge/docs-Português%20(Brasil)-purple)](./docs/README.pt-BR.md) [![Documentazione in italiano](https://img.shields.io/badge/docs-Italian-red)](./docs/README.it.md) ## ❌ Without Context7 diff --git a/docs/README.it.md b/docs/README.it.md new file mode 100644 index 0000000..c02ae4e --- /dev/null +++ b/docs/README.it.md @@ -0,0 +1,340 @@ +# Context7 MCP - Documentazione aggiornata per qualsiasi prompt + +[![Website](https://img.shields.io/badge/Website-context7.com-blue)](https://context7.com) [![smithery badge](https://smithery.ai/badge/@upstash/context7-mcp)](https://smithery.ai/server/@upstash/context7-mcp) [Install in VS Code (npx)](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) + +[![中文文档](https://img.shields.io/badge/docs-中文版-yellow)](./docs/README.zh-CN.md) [![한국어 문서](https://img.shields.io/badge/docs-한국어-green)](./docs/README.ko.md) [![Documentación en Español](https://img.shields.io/badge/docs-Español-orange)](./docs/README.es.md) [![Documentation en Français](https://img.shields.io/badge/docs-Français-blue)](./docs/README.fr.md) [![Documentação em Português (Brasil)](https://img.shields.io/badge/docs-Português%20(Brasil)-purple)](./docs/README.pt-BR.md) [![Documentazione in italiano](https://img.shields.io/badge/docs-Italian-red)](./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"] + } + } +} +``` + +
+Alternativa: Usa Bun + +```json +{ + "mcpServers": { + "context7": { + "command": "bunx", + "args": ["-y", "@upstash/context7-mcp@latest"] + } + } +} +``` + +
+ +
+Alternativa: Usa Deno + +```json +{ + "mcpServers": { + "context7": { + "command": "deno", + "args": ["run", "--allow-net", "npm:@upstash/context7-mcp"] + } + } +} +``` + +
+ +### 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 + +[Installa in VS Code (npx)](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) +[Installa in VS Code Insiders (npx)](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): + +
+ Clicca per visualizzare il contenuto del Dockerfile + + ```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`: + + ```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/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"](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 + +[![Star History Chart](https://api.star-history.com/svg?repos=upstash/context7&type=Date)](https://www.star-history.com/#upstash/context7&Date) + +## Licenza + +MIT