yujunjun/context7

Fork 0

mirror of https://github.com/upstash/context7.git synced 2025-06-26 23:50:04 +00:00

Abdusshh e66cdafe3c chore(format): run prettier

2025-06-07 00:24:20 +03:00

11 KiB

Raw Permalink Blame History

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, Windsurf, 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 Windsurf

Aggiungi questo al tuo file di configurazione Windsurf MCP. Vedi Windsurf 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": {
      "command": {
        "path": "npx",
        "args": ["-y", "@upstash/context7-mcp@latest"]
      },
      "settings": {}
    }
  }
}

Installare in Claude Code

Esegui questo comando. Vedi Claude Code MCP docs per ulteriori informazioni.

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 per ulteriori informazioni.

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

Utilizzo di Docker

Se preferisci eseguire il server MCP in un contenitore Docker:

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 .
```
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.
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 10000): Numero massimo di token da restituire. I valori inferiori a 10000 vengono automaticamente aumentati a 10000.

Sviluppo

Clona il progetto e installa le dipendenze:

bun i

Compila:

bun 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

Prova a rimuovere @latest dal nome del pacchetto.
Prova a usare bunx come alternativa.
Prova a usare deno come alternativa.
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

Storico delle Stelle

Licenza

MIT

11 KiB Raw Permalink Blame History Unescape Escape