Context7 Platform -- Up-to-date docs for AI agents
Fix i18n README files for proper markdown rendering (#1527)
Will50fd7d28fdf3
diff --git a/i18n/README.de.md b/i18n/README.de.mdindex a9681ebf..9c9c1881 100644--- a/i18n/README.de.md+++ b/i18n/README.de.md@@ -63,6 +63,7 @@ Der empfohlene Ansatz ist die folgende Konfiguration in deine Cursor-Datei `~/.c<details><summary>Alternative: Bun verwenden</summary>+```json{"mcpServers": {@@ -74,8 +75,10 @@ Der empfohlene Ansatz ist die folgende Konfiguration in deine Cursor-Datei `~/.c}```</details>+<details><summary>Alternative: Deno verwenden</summary>+```json{"mcpServers": {@@ -87,6 +90,7 @@ Der empfohlene Ansatz ist die folgende Konfiguration in deine Cursor-Datei `~/.c}```</details>+### Installation in WindsurfFüge dies zu deiner Windsurf MCP-Konfigurationsdatei hinzu. Siehe die [Windsurf MCP Dokumentation](https://docs.windsurf.com/windsurf/mcp) für mehr Informationen.```json@@ -99,6 +103,7 @@ Füge dies zu deiner Windsurf MCP-Konfigurationsdatei hinzu. Siehe die [Windsurf}}```+### Installation in VS Code[<img alt="In VS Code installieren (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)[<img alt="In VS Code Insiders installieren (npx)" src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Install%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)@@ -114,6 +119,7 @@ Füge dies zu deiner VS Code MCP-Konfigurationsdatei hinzu. Siehe die [VS Code M}}```+### Installation in ZedEs kann über [Zed Extensions](https://zed.dev/extensions?query=Context7) installiert werden oder du kannst dies zu deiner Zed `settings.json` hinzufügen. Siehe die [Zed Context Server Dokumentation](https://zed.dev/docs/assistant/context-servers) für mehr Informationen.```json@@ -127,11 +133,13 @@ Es kann über [Zed Extensions](https://zed.dev/extensions?query=Context7) instal}}```+### Installation in Claude CodeFühre diesen Befehl aus. Siehe die [Claude Code MCP Dokumentation](https://docs.anthropic.com/de/docs/claude-code/mcp) für mehr Informationen.```shclaude mcp add context7 -- npx -y @upstash/context7-mcp@latest```+### Installation in Claude DesktopFüge dies zu deiner Claude Desktop `claude_desktop_config.json` Datei hinzu. Siehe die [Claude Desktop MCP Dokumentation](https://modelcontextprotocol.io/quickstart/user) für mehr Informationen.```json@@ -144,6 +152,7 @@ Füge dies zu deiner Claude Desktop `claude_desktop_config.json` Datei hinzu. Si}}```+### Installation im Copilot Coding AgentFüge die folgende Konfiguration zum Abschnitt `mcp` deiner Copilot Coding Agent-Konfigurationsdatei hinzu (Repository->Settings->Copilot->Coding agent->MCP configuration):```json@@ -158,6 +167,7 @@ Füge die folgende Konfiguration zum Abschnitt `mcp` deiner Copilot Coding Agent}```Weitere Informationen findest du in der [offiziellen GitHub-Dokumentation](https://docs.github.com/en/enterprise-cloud@latest/copilot/how-tos/agents/copilot-coding-agent/extending-copilot-coding-agent-with-mcp).+### Installation im Copilot CLI1. Öffne die MCP-Konfigurationsdatei von Copilot CLI. Der Ort ist `~/.copilot/mcp-config.json` (wobei `~` dein Home-Verzeichnis ist).2. Füge Folgendes zum `mcpServers`-Objekt in deiner `mcp-config.json`-Datei hinzu:@@ -189,12 +199,14 @@ Oder für einen lokalen Server:}```Falls die `mcp-config.json`-Datei nicht existiert, erstelle sie.+### Docker verwendenWenn du den MCP-Server lieber in einem Docker-Container ausführen möchtest:1. **Docker-Image erstellen:**Erstelle zunächst ein `Dockerfile` im Projekt-Root (oder an einem Ort deiner Wahl):<details><summary>Klicke, um den Dockerfile-Inhalt zu sehen</summary>+```DockerfileFROM node:18-alpineWORKDIR /app@@ -206,6 +218,7 @@ Wenn du den MCP-Server lieber in einem Docker-Container ausführen möchtest:CMD ["context7-mcp"]```</details>+Baue dann das Image mit einem Tag (z.B. `context7-mcp`). **Stelle sicher, dass Docker Desktop (oder der Docker-Daemon) läuft.** Führe den folgenden Befehl in dem Verzeichnis aus, in dem du das `Dockerfile` gespeichert hast:```bashdocker build -t context7-mcp .@@ -228,6 +241,7 @@ Wenn du den MCP-Server lieber in einem Docker-Container ausführen möchtest:}```_Hinweis: Dies ist eine Beispielkonfiguration. Bitte beziehe dich auf die spezifischen Beispiele für deinen MCP-Client (wie Cursor, VS Code usw.), die weiter oben in dieser README beschrieben sind, um die Struktur anzupassen (z.B. `mcpServers` vs `servers`). Stelle außerdem sicher, dass der Bildname in `args` mit dem beim `docker build`-Befehl verwendeten Tag übereinstimmt._+### Verfügbare Tools- `resolve-library-id`: Löst einen allgemeinen Bibliotheksnamen in eine Context7-kompatible Bibliotheks-ID auf.- `query` (erforderlich): Die Frage oder Aufgabe des Benutzers (zur Relevanzranking)@@ -235,6 +249,7 @@ Wenn du den MCP-Server lieber in einem Docker-Container ausführen möchtest:- `query-docs`: Ruft die Dokumentation für eine Bibliothek mit einer Context7-kompatiblen Bibliotheks-ID ab.- `libraryId` (erforderlich): Exakte Context7-kompatible Bibliotheks-ID (z.B. `/mongodb/docs`, `/vercel/next.js`)- `query` (erforderlich): Die Frage oder Aufgabe, für die relevante Dokumentation abgerufen werden soll+## EntwicklungKlone das Projekt und installiere die Abhängigkeiten:```bash@@ -244,6 +259,7 @@ Bauen:```bashpnpm run build```+### Lokales Konfigurationsbeispiel```json{@@ -255,11 +271,14 @@ pnpm run build}}```+### Testen mit MCP Inspector```bashnpx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp@latest```+## Fehlerbehebung+### ERR_MODULE_NOT_FOUNDWenn du diesen Fehler siehst, versuche `bunx` anstelle von `npx` zu verwenden.```json@@ -273,6 +292,7 @@ Wenn du diesen Fehler siehst, versuche `bunx` anstelle von `npx` zu verwenden.}```Dies löst häufig Probleme bei der Modulauflösung, besonders in Umgebungen, in denen `npx` Pakete nicht ordnungsgemäß installiert oder auflöst.+### ESM-AuflösungsproblemeWenn du einen Fehler wie `Error: Cannot find module 'uriTemplate.js'` bekommst, versuche mit dem Flag `--experimental-vm-modules` auszuführen:```json@@ -285,13 +305,16 @@ Wenn du einen Fehler wie `Error: Cannot find module 'uriTemplate.js'` bekommst,}}```+### MCP-Client-Fehler1. Versuche, `@latest` aus dem Paketnamen zu entfernen.2. Versuche, `bunx` als Alternative zu verwenden.3. Versuche, `deno` als Alternative zu verwenden.4. Stelle sicher, dass du Node v18 oder höher verwendest, um native Fetch-Unterstützung mit `npx` zu haben.+## HaftungsausschlussContext7-Projekte werden von der Community beigetragen, und obwohl wir uns bemühen, eine hohe Qualität aufrechtzuerhalten, können wir die Genauigkeit, Vollständigkeit oder Sicherheit aller Bibliotheksdokumentationen nicht garantieren. Die in Context7 aufgeführten Projekte werden von ihren jeweiligen Eigentümern entwickelt und gepflegt, nicht von Context7. Wenn du auf verdächtige, unangemessene oder potenziell schädliche Inhalte stößt, verwende bitte die Schaltfläche "Melden" auf der Projektseite, um uns sofort zu benachrichtigen. Wir nehmen alle Berichte ernst und werden gemeldete Inhalte umgehend überprüfen, um die Integrität und Sicherheit unserer Plattform zu gewährleisten. Durch die Nutzung von Context7 erkennst du an, dass du dies nach eigenem Ermessen und auf eigenes Risiko tust.+## Context7 in den Medien- [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)@@ -299,7 +322,9 @@ Context7-Projekte werden von der Community beigetragen, und obwohl wir uns bemü- [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)+## Verlauf der Sterne[](https://www.star-history.com/#upstash/context7&Date)+## LizenzMITdiff --git a/i18n/README.es.md b/i18n/README.es.mdindex 8af19437..fe81590d 100644--- a/i18n/README.es.md+++ b/i18n/README.es.md@@ -63,6 +63,7 @@ Pegar la siguiente configuración en tu archivo `~/.cursor/mcp.json` de Cursor e<details><summary>Alternativa: Usar Bun</summary>+```json{"mcpServers": {@@ -74,8 +75,10 @@ Pegar la siguiente configuración en tu archivo `~/.cursor/mcp.json` de Cursor e}```</details>+<details><summary>Alternativa: Usar Deno</summary>+```json{"mcpServers": {@@ -87,6 +90,7 @@ Pegar la siguiente configuración en tu archivo `~/.cursor/mcp.json` de Cursor e}```</details>+### Instalar en WindsurfAñade esto a tu archivo de configuración MCP de Windsurf. Consulta la [documentación de MCP de Windsurf](https://docs.windsurf.com/windsurf/mcp) para más información.```json@@ -99,6 +103,7 @@ Añade esto a tu archivo de configuración MCP de Windsurf. Consulta la [documen}}```+### Instalar en VS Code[<img alt="Instalar en VS Code (npx)" src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Instalar%20Context7%20MCP&color=0098FF">](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522context7%2522%252C%2522config%2522%253A%257B%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522%2540upstash%252Fcontext7-mcp%2540latest%2522%255D%257D%257D)[<img alt="Instalar en VS Code Insiders (npx)" src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Instalar%20Context7%20MCP&color=24bfa5">](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522context7%2522%252C%2522config%2522%253A%257B%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522%2540upstash%252Fcontext7-mcp%2540latest%2522%255D%257D%257D)@@ -114,11 +119,13 @@ Añade esto a tu archivo de configuración MCP de VS Code. Consulta la [document}}```+### Instalar en Claude CodeEjecuta este comando. Consulta la [documentación de MCP de Claude Code](https://docs.anthropic.com/es/docs/claude-code/mcp) para más información.```shclaude mcp add context7 -- npx -y @upstash/context7-mcp@latest```+### Instalar en Claude DesktopAñade esto a tu archivo `claude_desktop_config.json` de Claude Desktop. Consulta la [documentación de MCP de Claude Desktop](https://modelcontextprotocol.io/quickstart/user) para más información.```json@@ -131,6 +138,7 @@ Añade esto a tu archivo `claude_desktop_config.json` de Claude Desktop. Consult}}```+### Instalar en Copilot Coding AgentAgrega la siguiente configuración a la sección `mcp` de tu archivo de configuración de Copilot Coding Agent (Repository->Settings->Copilot->Coding agent->MCP configuration):```json@@ -145,6 +153,7 @@ Agrega la siguiente configuración a la sección `mcp` de tu archivo de configur}```Para más información, consulta la [documentación oficial de GitHub](https://docs.github.com/en/enterprise-cloud@latest/copilot/how-tos/agents/copilot-coding-agent/extending-copilot-coding-agent-with-mcp).+### Instalar en Copilot CLI1. Abre el archivo de configuración MCP de Copilot CLI. La ubicación es `~/.copilot/mcp-config.json` (donde `~` es tu directorio home).2. Agrega lo siguiente al objeto `mcpServers` en tu archivo `mcp-config.json`:@@ -176,6 +185,7 @@ O, para un servidor local:}```Si el archivo `mcp-config.json` no existe, créalo.+### Herramientas Disponibles- `resolve-library-id`: Resuelve un nombre de una biblioteca general en un ID de biblioteca compatible con Context7.- `query` (requerido): La pregunta o tarea del usuario (para ranking de relevancia)@@ -183,6 +193,7 @@ Si el archivo `mcp-config.json` no existe, créalo.- `query-docs`: Obtiene documentación para una biblioteca utilizando un ID de biblioteca compatible con Context7.- `libraryId` (requerido): ID exacto compatible con Context7 (por ejemplo, `/mongodb/docs`, `/vercel/next.js`)- `query` (requerido): La pregunta o tarea para obtener documentación relevante+## DesarrolloClona el proyecto e instala las dependencias:```bash@@ -192,6 +203,7 @@ Compila:```bashpnpm run build```+### Ejemplo de Configuración Local```json{@@ -203,11 +215,14 @@ pnpm run build}}```+### Probando con MCP Inspector```bashnpx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp@latest```+## Solución de Problemas+### ERR_MODULE_NOT_FOUNDSi ves este error, intenta usar `bunx` en lugar de `npx`.```json@@ -221,10 +236,12 @@ Si ves este error, intenta usar `bunx` en lugar de `npx`.}```Esto a menudo resuelve problemas de resolución de módulos, especialmente en entornos donde `npx` no instala o resuelve paquetes correctamente.+### Errores del Cliente MCP1. Intenta eliminar `@latest` del nombre del paquete.2. Intenta usar `bunx` como alternativa.3. Intenta usar `deno` como alternativa.+## Context7 en los Medios- [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)@@ -232,7 +249,9 @@ Esto a menudo resuelve problemas de resolución de módulos, especialmente en en- [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)+## Historial de Estrellas[](https://www.star-history.com/#upstash/context7&Date)+## LicenciaMITdiff --git a/i18n/README.fr.md b/i18n/README.fr.mdindex 73477b6c..67af111f 100644--- a/i18n/README.fr.md+++ b/i18n/README.fr.md@@ -63,6 +63,7 @@ La méthode recommandée est de coller la configuration suivante dans votre fich<details><summary>Alternative : Utiliser Bun</summary>+```json{"mcpServers": {@@ -74,8 +75,10 @@ La méthode recommandée est de coller la configuration suivante dans votre fich}```</details>+<details><summary>Alternative : Utiliser Deno</summary>+```json{"mcpServers": {@@ -87,6 +90,7 @@ La méthode recommandée est de coller la configuration suivante dans votre fich}```</details>+### Installation dans WindsurfAjoutez ceci à votre fichier de configuration MCP Windsurf. Voir la [documentation Windsurf MCP](https://docs.windsurf.com/windsurf/mcp) pour plus d’informations.```json@@ -99,6 +103,7 @@ Ajoutez ceci à votre fichier de configuration MCP Windsurf. Voir la [documentat}}```+### Installation dans VS Code[<img alt="Installer dans VS Code (npx)" src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Installer%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="Installer dans VS Code Insiders (npx)" src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Installer%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)@@ -114,6 +119,7 @@ Ajoutez ceci à votre fichier de configuration MCP VS Code. Voir la [documentati}}```+### Installation dans ZedPeut être installé via [Zed Extensions](https://zed.dev/extensions?query=Context7) ou en ajoutant ceci à votre `settings.json` Zed. Voir la [documentation Zed Context Server](https://zed.dev/docs/assistant/context-servers).```json@@ -127,11 +133,13 @@ Peut être installé via [Zed Extensions](https://zed.dev/extensions?query=Conte}}```+### Installation dans Claude CodeExécutez cette commande. Voir la [documentation Claude Code MCP](https://docs.anthropic.com/fr/docs/claude-code/mcp).```shclaude mcp add context7 -- npx -y @upstash/context7-mcp@latest```+### Installation dans Claude DesktopAjoutez ceci à votre fichier `claude_desktop_config.json`. Voir la [documentation Claude Desktop MCP](https://modelcontextprotocol.io/quickstart/user).```json@@ -144,6 +152,7 @@ Ajoutez ceci à votre fichier `claude_desktop_config.json`. Voir la [documentati}}```+### Installation dans BoltAIOuvrez la page "Settings" de l'application, naviguez jusqu'à "Plugins", et entrez le JSON suivant :```json@@ -157,6 +166,7 @@ Ouvrez la page "Settings" de l'application, naviguez jusqu'à "Plugins", et entr}```Une fois enregistré, saisissez dans le chat `query-docs` suivi de votre ID de documentation Context7 (par exemple, `query-docs /nuxt/ui`). Plus d'informations sont disponibles sur le [site de documentation BoltAI](https://docs.boltai.com/docs/plugins/mcp-servers). Pour BoltAI sur iOS, [consultez ce guide](https://docs.boltai.com/docs/boltai-mobile/mcp-servers).+### Installation dans Copilot Coding AgentAjoutez la configuration suivante à la section `mcp` de votre fichier de configuration Copilot Coding Agent (Repository->Settings->Copilot->Coding agent->MCP configuration) :```json@@ -171,6 +181,7 @@ Ajoutez la configuration suivante à la section `mcp` de votre fichier de config}```Pour plus d'informations, consultez la [documentation officielle GitHub](https://docs.github.com/en/enterprise-cloud@latest/copilot/how-tos/agents/copilot-coding-agent/extending-copilot-coding-agent-with-mcp).+### Installation dans Copilot CLI1. Ouvrez le fichier de configuration MCP de Copilot CLI. L'emplacement est `~/.copilot/mcp-config.json` (où `~` est votre répertoire personnel).2. Ajoutez ce qui suit à l'objet `mcpServers` dans votre fichier `mcp-config.json` :@@ -202,12 +213,14 @@ Ou, pour un serveur local :}```Si le fichier `mcp-config.json` n'existe pas, créez-le.+### Utilisation avec DockerSi vous préférez exécuter le serveur MCP dans un conteneur Docker :1. **Construisez l’image Docker :**Créez un `Dockerfile` à la racine du projet (ou ailleurs) :<details><summary>Voir le contenu du Dockerfile</summary>+```DockerfileFROM node:18-alpineWORKDIR /app@@ -219,6 +232,7 @@ Si vous préférez exécuter le serveur MCP dans un conteneur Docker :CMD ["context7-mcp"]```</details>+Puis, construisez l’image :```bashdocker build -t context7-mcp .@@ -241,6 +255,7 @@ Si vous préférez exécuter le serveur MCP dans un conteneur Docker :}```_Note : Ceci est un exemple. Adaptez la structure selon votre client MCP (voir plus haut dans ce README). Assurez-vous que le nom de l’image dans `args` correspond au tag utilisé lors du build._+### Installation sous WindowsLa configuration sous Windows est légèrement différente par rapport à Linux ou macOS (_`Cline` est utilisé dans l'exemple_). Le même principe s'applique à d'autres éditeurs; référez-vous à la configuration de `command` et `args`.```json@@ -255,11 +270,13 @@ La configuration sous Windows est légèrement différente par rapport à Linux}}```+### Outils disponibles- `resolve-library-id` : Résout un nom de bibliothèque général en un ID compatible Context7.- `libraryName` (obligatoire)- `query-docs` : Récupère la documentation d’une bibliothèque via un ID Context7.- `libraryId` (obligatoire)+## DéveloppementClonez le projet et installez les dépendances :```bash@@ -269,6 +286,7 @@ Build :```bashpnpm run build```+### Exemple de configuration locale```json{@@ -280,11 +298,14 @@ pnpm run build}}```+### Tester avec MCP Inspector```bashnpx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp@latest```+## Dépannage+### ERR_MODULE_NOT_FOUNDSi vous voyez cette erreur, essayez d’utiliser `bunx` à la place de `npx`.```json@@ -298,6 +319,7 @@ Si vous voyez cette erreur, essayez d’utiliser `bunx` à la place de `npx`.}```Cela résout souvent les problèmes de résolution de modules, surtout si `npx` n’installe ou ne résout pas correctement les packages.+### Problèmes de résolution ESMSi vous rencontrez une erreur comme : `Error: Cannot find module 'uriTemplate.js'` essayez d'exécuter avec le drapeau `--experimental-vm-modules` :```json@@ -310,13 +332,16 @@ Si vous rencontrez une erreur comme : `Error: Cannot find module 'uriTemplate.js}}```+### Erreurs client MCP1. Essayez de retirer `@latest` du nom du package.2. Essayez d'utiliser `bunx` comme alternative.3. Essayez d'utiliser `deno` comme alternative.4. Assurez-vous d'utiliser Node v18 ou supérieur pour avoir le support natif de fetch avec `npx`.+## Clause de non-responsabilitéLes projets Context7 sont des contributions de la communauté, et bien que nous nous efforcions de maintenir une haute qualité, nous ne pouvons garantir l'exactitude, l'exhaustivité ou la sécurité de toute la documentation des bibliothèques. Les projets listés dans Context7 sont développés et maintenus par leurs propriétaires respectifs, et non par Context7. Si vous rencontrez un contenu suspect, inapproprié ou potentiellement nuisible, veuillez utiliser le bouton "Signaler" sur la page du projet pour nous le faire savoir immédiatement. Nous prenons tous les signalements au sérieux et examinerons rapidement les contenus signalés pour maintenir l'intégrité et la sécurité de notre plateforme. En utilisant Context7, vous reconnaissez que vous le faites à votre propre discrétion et à vos risques et périls.+## Context7 dans les médias- [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)@@ -326,7 +351,9 @@ Les projets Context7 sont des contributions de la communauté, et bien que nous- [Income stream surfers: "Context7: The New MCP Server That Will CHANGE AI Coding"](https://www.youtube.com/watch?v=PS-2Azb-C3M)- [AICodeKing: "Context7 + Cline & RooCode: This MCP Server Makes CLINE 100X MORE EFFECTIVE!"](https://www.youtube.com/watch?v=qZfENAPMnyo)- [Sean Kochel: "5 MCP Servers For Vibe Coding Glory (Just Plug-In & Go)"](https://www.youtube.com/watch?v=LqTQi8qexJM)+## Historique des stars[](https://www.star-history.com/#upstash/context7&Date)+## LicenceMITdiff --git a/i18n/README.id-ID.md b/i18n/README.id-ID.mdindex 29298ca3..2504b5d8 100644--- a/i18n/README.id-ID.md+++ b/i18n/README.id-ID.md@@ -43,6 +43,7 @@ Kunjungi [panduan penambahan proyek](./adding-projects.md) untuk mempelajari car- Cursor, Windsurf, Claude Desktop, atau klien MCP lainnya<details><summary><b>Menginstal melalui Smithery</b></summary>+Untuk menginstal Context7 MCP Server untuk klien apa pun secara otomatis melalui [Smithery](https://smithery.ai/server/@upstash/context7-mcp):```bash@@ -52,11 +53,14 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <NAMA_KLIEN>Anda dapat menemukan kunci Smithery Anda di [halaman web Smithery.ai](https://smithery.ai/server/@upstash/context7-mcp).</details>+<details><summary><b>Instal di Cursor</b></summary>+Pergi ke: `Settings` -> `Cursor Settings` -> `MCP` -> `Add new global MCP server`Menyalin konfigurasi berikut ke file `~/.cursor/mcp.json` Anda adalah pendekatan yang direkomendasikan. Anda juga dapat menginstalnya di proyek tertentu dengan membuat `.cursor/mcp.json` di folder proyek Anda. Lihat [dokumentasi Cursor MCP](https://docs.cursor.com/context/model-context-protocol) untuk info lebih lanjut.> Sejak Cursor 1.0, Anda dapat mengklik tombol instal di bawah untuk instalasi satu klik instan.+#### Koneksi Server Remote Cursor[](https://cursor.com/install-mcp?name=context7&config=eyJ1cmwiOiJodHRwczovL21jcC5jb250ZXh0Ny5jb20vbWNwIn0%3D)```json@@ -68,6 +72,7 @@ Menyalin konfigurasi berikut ke file `~/.cursor/mcp.json` Anda adalah pendekatan}}```+#### Koneksi Server Lokal Cursor[](https://cursor.com/install-mcp?name=context7&config=eyJjb21tYW5kIjoibnB4IC15IEB1cHN0YXNoL2NvbnRleHQ3LW1jcCJ9)```json@@ -82,6 +87,7 @@ Menyalin konfigurasi berikut ke file `~/.cursor/mcp.json` Anda adalah pendekatan```<details><summary>Alternatif: Gunakan Bun</summary>+[](https://cursor.com/install-mcp?name=context7&config=eyJjb21tYW5kIjoiYnVueCAteSBAdXBzdGFzaC9jb250ZXh0Ny1tY3AifQ%3D%3D)```json{@@ -94,8 +100,10 @@ Menyalin konfigurasi berikut ke file `~/.cursor/mcp.json` Anda adalah pendekatan}```</details>+<details><summary>Alternatif: Gunakan Deno</summary>+[](https://cursor.com/install-mcp?name=context7&config=eyJjb21tYW5kIjoiZGVubyBydW4gLS1hbGxvdy1lbnYgLS1hbGxvdy1uZXQgbnBtOkB1cHN0YXNoL2NvbnRleHQ3LW1jcCJ9)```json{@@ -108,11 +116,16 @@ Menyalin konfigurasi berikut ke file `~/.cursor/mcp.json` Anda adalah pendekatan}```</details>+</details>+<details><summary><b>Instal di Windsurf</b></summary>+Tambahkan ini ke file konfigurasi MCP Windsurf Anda. Lihat [dokumentasi MCP Windsurf](https://docs.windsurf.com/windsurf/mcp) untuk info lebih lanjut.+#### Koneksi Server Remote Windsurf+```json{"mcpServers": {@@ -122,7 +135,9 @@ Tambahkan ini ke file konfigurasi MCP Windsurf Anda. Lihat [dokumentasi MCP Wind}}```+#### Koneksi Server Lokal Windsurf+```json{"mcpServers": {@@ -134,11 +149,15 @@ Tambahkan ini ke file konfigurasi MCP Windsurf Anda. Lihat [dokumentasi MCP Wind}```</details>+<details><summary><b>Instal di Trae</b></summary>+Gunakan fitur Tambah secara manual dan isi informasi konfigurasi JSON untuk server MCP tersebut.Untuk detail lebih lanjut, kunjungi [dokumentasi Trae](https://docs.trae.ai/ide/model-context-protocol?_lang=en).+#### Koneksi Server Remote Trae+```json{"mcpServers": {@@ -148,7 +167,9 @@ Untuk detail lebih lanjut, kunjungi [dokumentasi Trae](https://docs.trae.ai/ide/}}```+#### Koneksi Server Lokal Trae+```json{"mcpServers": {@@ -160,12 +181,16 @@ Untuk detail lebih lanjut, kunjungi [dokumentasi Trae](https://docs.trae.ai/ide/}```</details>+<details><summary><b>Instal di VS Code</b></summary>+[<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)[<img alt="Install in VS Code Insiders (npx)" src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Install%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)Tambahkan ini ke file konfigurasi MCP VS Code Anda. Lihat [dokumentasi MCP VS Code](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) untuk info lebih lanjut.+#### Koneksi Server Remote VS Code+```json"mcp": {"servers": {@@ -176,7 +201,9 @@ Tambahkan ini ke file konfigurasi MCP VS Code Anda. Lihat [dokumentasi MCP VS Co}}```+#### Koneksi Server Lokal VS Code+```json"mcp": {"servers": {@@ -189,8 +216,10 @@ Tambahkan ini ke file konfigurasi MCP VS Code Anda. Lihat [dokumentasi MCP VS Co}```</details>+<details><summary><b>Instal di Visual Studio 2022</b></summary>+Anda dapat mengonfigurasi Context7 MCP di Visual Studio 2022 dengan mengikuti [dokumentasi Server MCP Visual Studio](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022).Tambahkan ini ke file konfigurasi MCP Visual Studio Anda (lihat [dokumentasi Visual Studio](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022) untuk detailnya):```json@@ -221,8 +250,10 @@ Atau, untuk server lokal:```Untuk informasi dan pemecahan masalah lebih lanjut, lihat [dokumentasi Server MCP Visual Studio](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022).</details>+<details><summary><b>Instal di Zed</b></summary>+Dapat diinstal melalui [Ekstensi Zed](https://zed.dev/extensions?query=Context7) atau Anda dapat menambahkan ini ke `settings.json` Zed Anda. Lihat [dokumentasi Server Konteks Zed](https://zed.dev/docs/assistant/context-servers) untuk info lebih lanjut.```json{@@ -236,8 +267,10 @@ Dapat diinstal melalui [Ekstensi Zed](https://zed.dev/extensions?query=Context7)}```</details>+<details><summary><b>Instal di Gemini CLI</b></summary>+Lihat [Konfigurasi Gemini CLI](https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/configuration.md) untuk detailnya.1. Buka file pengaturan Gemini CLI. Lokasinya adalah `~/.gemini/settings.json` (di mana `~` adalah direktori home Anda).2. Tambahkan berikut ini ke objek `mcpServers` di file `settings.json` Anda:@@ -263,20 +296,28 @@ Atau, untuk server lokal:```Jika objek `mcpServers` tidak ada, buatlah.</details>+<details><summary><b>Instal di Claude Code</b></summary>+Jalankan perintah ini. Lihat [dokumentasi MCP Claude Code](https://docs.anthropic.com/id/docs/claude-code/mcp) untuk info lebih lanjut.+#### Koneksi Server Lokal Claude Code+```shclaude mcp add context7 -- npx -y @upstash/context7-mcp```+#### Koneksi Server Remote Claude Code+```shclaude mcp add --transport http context7 https://mcp.context7.com/mcp```</details>+<details><summary><b>Instal di Claude Desktop</b></summary>+Tambahkan ini ke file `claude_desktop_config.json` Claude Desktop Anda. Lihat [dokumentasi MCP Claude Desktop](https://modelcontextprotocol.io/quickstart/user) untuk info lebih lanjut.```json{@@ -289,18 +330,22 @@ Tambahkan ini ke file `claude_desktop_config.json` Claude Desktop Anda. Lihat [d}```</details>+<details><summary><b>Instal di Cline</b></summary>+Anda dapat dengan mudah menginstal Context7 melalui [Pasar Server MCP Cline](https://cline.bot/mcp-marketplace) dengan mengikuti petunjuk berikut:1. Buka **Cline**.2. Klik ikon menu hamburger (☰) untuk masuk ke bagian **Server MCP**.3. Gunakan bilah pencarian di tab **Marketplace** untuk menemukan *Context7*.4. Klik tombol **Instal**.</details>+<details><summary><b>Instal di BoltAI</b></summary>+Buka halaman "Pengaturan" aplikasi, navigasikan ke "Plugin," dan masukkan JSON berikut:```json{@@ -314,13 +359,16 @@ Buka halaman "Pengaturan" aplikasi, navigasikan ke "Plugin," dan masukkan JSON b```Setelah disimpan, masukkan di obrolan `query-docs` diikuti oleh ID dokumentasi Context7 Anda (contoh: `query-docs /nuxt/ui`). Informasi lebih lanjut tersedia di [situs dokumentasi BoltAI](https://docs.boltai.com/docs/plugins/mcp-servers). Untuk BoltAI di iOS, [lihat panduan ini](https://docs.boltai.com/docs/boltai-mobile/mcp-servers).</details>+<details><summary><b>Menggunakan Docker</b></summary>+Jika Anda lebih suka menjalankan server MCP dalam wadah Docker:1. **Bangun Gambar Docker:**Pertama, buat `Dockerfile` di direktori utama proyek (atau di mana pun Anda inginkan):<details><summary>Klik untuk melihat isi Dockerfile</summary>+```DockerfileFROM node:18-alpineWORKDIR /app@@ -332,6 +380,7 @@ Jika Anda lebih suka menjalankan server MCP dalam wadah Docker:CMD ["context7-mcp"]```</details>+Kemudian, bangun gambar menggunakan tag (contoh: `context7-mcp`). **Pastikan Docker Desktop (atau daemon Docker) berjalan.** Jalankan perintah berikut di direktori yang sama tempat Anda menyimpan `Dockerfile`:```bashdocker build -t context7-mcp .@@ -355,8 +404,10 @@ Jika Anda lebih suka menjalankan server MCP dalam wadah Docker:```_Catatan: Ini adalah contoh konfigurasi. Silakan merujuk ke contoh spesifik untuk klien MCP Anda (seperti Cursor, VS Code, dll.) sebelumnya di README ini untuk menyesuaikan struktur (misalnya, `mcpServers` vs `servers`). Juga, pastikan nama gambar di `args` sesuai dengan tag yang digunakan saat perintah `docker build`._</details>+<details><summary><b>Instal di Windows</b></summary>+Konfigurasi di Windows sedikit berbeda dibandingkan Linux atau macOS (_`Cline` digunakan sebagai contoh_). Prinsip yang sama berlaku untuk editor lainnya; lihat konfigurasi `command` dan `args`.```json{@@ -371,9 +422,12 @@ Konfigurasi di Windows sedikit berbeda dibandingkan Linux atau macOS (_`Cline` d}```</details>+<details><summary><b>Instal di Augment Code</b></summary>+Untuk mengonfigurasi Context7 MCP di Augment Code, Anda dapat menggunakan antarmuka grafis atau konfigurasi manual.+### **A. Menggunakan UI Augment Code**1. Klik menu hamburger.2. Pilih **Pengaturan**.@@ -387,6 +441,7 @@ Untuk mengonfigurasi Context7 MCP di Augment Code, Anda dapat menggunakan antarm7. Klik tombol **Tambah**.Setelah server MCP ditambahkan, Anda dapat mulai menggunakan fitur dokumentasi kode terkini Context7 langsung di Augment Code.---+### **B. Konfigurasi Manual**1. Tekan Cmd/Ctrl Shift P atau pergi ke menu hamburger di panel Augment2. Pilih Edit Pengaturan@@ -405,10 +460,14 @@ Untuk mengonfigurasi Context7 MCP di Augment Code, Anda dapat menggunakan antarm```Setelah server MCP ditambahkan, restart editor Anda. Jika Anda menerima kesalahan, periksa sintaks untuk memastikan tanda kurung atau koma penutup tidak hilang.</details>+<details><summary><b>Instal di Roo Code</b></summary>+Tambahkan ini ke file konfigurasi MCP Roo Code Anda. Lihat [dokumentasi MCP Roo Code](https://docs.roocode.com/features/mcp/using-mcp-in-roo) untuk info lebih lanjut.+#### Koneksi Server Remote Roo Code+```json{"mcpServers": {@@ -419,7 +478,9 @@ Tambahkan ini ke file konfigurasi MCP Roo Code Anda. Lihat [dokumentasi MCP Roo}}```+#### Koneksi Server Lokal Roo Code+```json{"mcpServers": {@@ -431,8 +492,10 @@ Tambahkan ini ke file konfigurasi MCP Roo Code Anda. Lihat [dokumentasi MCP Roo}```</details>+<details><summary><b>Instal di Zencoder</b></summary>+Untuk mengonfigurasi Context7 MCP di Zencoder, ikuti langkah-langkah berikut:1. Pergi ke menu Zencoder (...)2. Dari menu dropdown, pilih Alat Agen@@ -449,8 +512,10 @@ Untuk mengonfigurasi Context7 MCP di Zencoder, ikuti langkah-langkah berikut:```Setelah server MCP ditambahkan, Anda dapat dengan mudah terus menggunakannya.</details>+<details><summary><b>Instal di Amazon Q Developer CLI</b></summary>+Tambahkan ini ke file konfigurasi Amazon Q Developer CLI Anda. Lihat [dokumentasi Amazon Q Developer CLI](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-configuration.html) untuk detail lebih lanjut.```json{@@ -463,8 +528,10 @@ Tambahkan ini ke file konfigurasi Amazon Q Developer CLI Anda. Lihat [dokumentas}```</details>+<details><summary><b>Instal di Qodo Gen</b></summary>+Lihat [dokumentasi Qodo Gen](https://docs.qodo.ai/qodo-documentation/qodo-gen/qodo-gen-chat/agentic-mode/agentic-tools-mcps) untuk detail lebih lanjut.1. Buka panel obrolan Qodo Gen di VSCode atau IntelliJ.2. Klik Hubungkan lebih banyak alat.@@ -480,8 +547,10 @@ Lihat [dokumentasi Qodo Gen](https://docs.qodo.ai/qodo-documentation/qodo-gen/qo}```</details>+<details><summary><b>Instal di JetBrains AI Assistant</b></summary>+Lihat [Dokumentasi JetBrains AI Assistant](https://www.jetbrains.com/help/ai-assistant/configure-an-mcp-server.html) untuk detail lebih lanjut.1. Di IDE JetBrains pergi ke `Pengaturan` -> `Alat` -> `Asisten AI` -> `Protokol Konteks Model (MCP)`2. Klik `+ Tambah`.@@ -500,8 +569,10 @@ Lihat [Dokumentasi JetBrains AI Assistant](https://www.jetbrains.com/help/ai-ass5. Klik `Terapkan` untuk menyimpan perubahan.6. Dengan cara yang sama context7 dapat ditambahkan untuk JetBrains Junie di `Pengaturan` -> `Alat` -> `Junie` -> `Pengaturan MCP`</details>+<details><summary><b>Instal di Warp</b></summary>+Lihat [Dokumentasi Protokol Konteks Model Warp](https://docs.warp.dev/knowledge-and-collaboration/mcp#adding-an-mcp-server) untuk detail.1. Navigasikan `Pengaturan` > `AI` > `Kelola server MCP`.2. Tambahkan server MCP baru dengan mengklik tombol `+ Tambah`.@@ -522,10 +593,14 @@ Lihat [Dokumentasi Protokol Konteks Model Warp](https://docs.warp.dev/knowledge-```4. Klik `Simpan` untuk menerapkan perubahan.</details>+<details><summary><b>Instal di Opencode</b></summary>+Tambahkan ini ke file konfigurasi Opencode Anda. Lihat [dokumentasi MCP Opencode](https://opencode.ai/docs/mcp-servers) untuk info lebih lanjut.+#### Koneksi Server Remote Opencode+```json"mcp": {"context7": {@@ -535,7 +610,9 @@ Tambahkan ini ke file konfigurasi Opencode Anda. Lihat [dokumentasi MCP Opencode}}```+#### Koneksi Server Lokal Opencode+```json{"mcp": {@@ -548,8 +625,10 @@ Tambahkan ini ke file konfigurasi Opencode Anda. Lihat [dokumentasi MCP Opencode}```</details>+<details><summary><b>Instal di Copilot Coding Agent</b></summary>+## Menggunakan Context7 dengan Copilot Coding AgentTambahkan konfigurasi berikut ke bagian `mcp` file konfigurasi Copilot Coding Agent Anda Repositori->Pengaturan->Copilot->Coding agent->Konfigurasi MCP:```json@@ -568,8 +647,10 @@ Tambahkan konfigurasi berikut ke bagian `mcp` file konfigurasi Copilot Coding Ag```Untuk informasi lebih lanjut, lihat [dokumentasi resmi GitHub](https://docs.github.com/en/enterprise-cloud@latest/copilot/how-tos/agents/copilot-coding-agent/extending-copilot-coding-agent-with-mcp).</details>+<details><summary><b>Instal di Copilot CLI</b></summary>+1. Buka file konfigurasi MCP Copilot CLI. Lokasinya adalah `~/.copilot/mcp-config.json` (di mana `~` adalah direktori home Anda).2. Tambahkan yang berikut ke objek `mcpServers` di file `mcp-config.json` Anda:```json@@ -601,8 +682,10 @@ Atau, untuk server lokal:```Jika file `mcp-config.json` tidak ada, buatlah.</details>+<details><summary><b>Instal di Kiro</b></summary>+Lihat [Dokumentasi Protokol Konteks Model Kiro](https://kiro.dev/docs/mcp/configuration/) untuk detail.1. Navigasikan `Kiro` > `Server MCP`2. Tambahkan server MCP baru dengan mengklik tombol `+ Tambah`.@@ -625,28 +708,38 @@ Lihat [Dokumentasi Protokol Konteks Model Kiro](https://kiro.dev/docs/mcp/config```4. Klik `Simpan` untuk menerapkan perubahan.</details>+<details><summary><b>Instal di OpenAI Codex</b></summary>+Lihat [OpenAI Codex](https://github.com/openai/codex) untuk informasi lebih lanjut.Tambahkan konfigurasi berikut ke pengaturan server MCP OpenAI Codex Anda:+#### Koneksi Server Lokal+```toml[mcp_servers.context7]args = ["-y", "@upstash/context7-mcp"]command = "npx"```+#### Koneksi Server Jarak Jauh+```toml[mcp_servers.context7]url = "https://mcp.context7.com/mcp"http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }```</details>+<details><summary><b>Instal di LM Studio</b></summary>+Lihat [Dukungan MCP LM Studio](https://lmstudio.ai/blog/lmstudio-v0.3.17) untuk informasi lebih lanjut.+#### Instal satu klik:[](https://lmstudio.ai/install-mcp?name=context7&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkB1cHN0YXNoL2NvbnRleHQ3LW1jcCJdfQ%3D%3D)+#### Pengaturan manual:1. Navigasikan ke `Program` (sisi kanan) > `Instal` > `Edit mcp.json`.2. Tempel konfigurasi yang diberikan di bawah:@@ -663,6 +756,7 @@ Lihat [Dukungan MCP LM Studio](https://lmstudio.ai/blog/lmstudio-v0.3.17) untuk3. Klik `Simpan` untuk menerapkan perubahan.4. Aktifkan/nonaktifkan server MCP dari sisi kanan, di bawah `Program`, atau dengan mengklik ikon colokan di bagian bawah kotak obrolan.</details>+## 🔨 Alat yang TersediaContext7 MCP menyediakan alat berikut yang dapat digunakan oleh LLM:- `resolve-library-id`: Mengubah nama pustaka umum menjadi ID pustaka yang kompatibel dengan Context7.@@ -671,7 +765,9 @@ Context7 MCP menyediakan alat berikut yang dapat digunakan oleh LLM:- `query-docs`: Mengambil dokumentasi untuk pustaka menggunakan ID pustaka yang kompatibel dengan Context7.- `libraryId` (wajib): ID pustaka yang kompatibel dengan Context7 (contoh: `/mongodb/docs`, `/vercel/next.js`)- `query` (wajib): Pertanyaan atau tugas untuk mendapatkan dokumentasi yang relevan+## 🛟 Tips+### Tambahkan Aturan> Jika Anda tidak ingin menambahkan `use context7` ke setiap permintaan, Anda dapat menentukan aturan sederhana di file `.windsurfrules` Anda di Windsurf atau dari bagian `Cursor Settings > Rules` di Cursor (atau yang setara di klien MCP Anda) untuk memanggil Context7 secara otomatis pada setiap pertanyaan kode:>@@ -682,6 +778,7 @@ Context7 MCP menyediakan alat berikut yang dapat digunakan oleh LLM:> ```>> Mulai saat itu, Anda akan mendapatkan dokumen Context7 dalam setiap percakapan terkait tanpa mengetik sesuatu tambahan. Anda dapat menambahkan kasus penggunaan Anda ke bagian match.+### Gunakan ID Pustaka> Jika Anda sudah tahu persis pustaka mana yang ingin digunakan, tambahkan ID Context7-nya ke permintaan Anda. Dengan begitu, server MCP Context7 dapat melewati langkah pencocokan pustaka dan langsung mengambil dokumen.>@@ -690,6 +787,7 @@ Context7 MCP menyediakan alat berikut yang dapat digunakan oleh LLM:> ```>> Sintaks garis miring memberi tahu alat MCP pustaka mana yang harus dimuat dokumennya.+## 💻 PengembanganSalin proyek dan instal dependensi:```bash@@ -703,6 +801,7 @@ Jalankan server:```bashnode packages/mcp/dist/index.js```+### Argumen CLI`context7-mcp` menerima bendera CLI berikut:- `--transport <stdio|http>` – Transportasi yang digunakan (`stdio` secara default).@@ -713,6 +812,7 @@ node packages/mcp/dist/index.js --transport http --port 8080```<details><summary><b>Contoh Konfigurasi Lokal</b></summary>+```json{"mcpServers": {@@ -724,15 +824,19 @@ node packages/mcp/dist/index.js --transport http --port 8080}```</details>+<details><summary><b>Pengujian dengan MCP Inspector</b></summary>+```bashnpx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp```</details>+## 🚨 Pemecahan Masalah<details><summary><b>Kesalahan Modul Tidak Ditemukan</b></summary>+Jika Anda mengalami `ERR_MODULE_NOT_FOUND`, coba gunakan `bunx` alih-alih `npx`:```json{@@ -746,8 +850,10 @@ Jika Anda mengalami `ERR_MODULE_NOT_FOUND`, coba gunakan `bunx` alih-alih `npx`:```Ini sering menyelesaikan masalah penyelesaian modul di lingkungan di mana `npx` tidak menginstal atau menyelesaikan paket dengan benar.</details>+<details><summary><b>Masalah Resolusi ESM</b></summary>+Untuk kesalahan seperti `Error: Cannot find module 'uriTemplate.js'`, coba gunakan bendera `--experimental-vm-modules`:```json{@@ -760,8 +866,10 @@ Untuk kesalahan seperti `Error: Cannot find module 'uriTemplate.js'`, coba gunak}```</details>+<details><summary><b>Masalah TLS/Sertifikat</b></summary>+Gunakan bendera `--experimental-fetch` untuk melewati masalah terkait TLS:```json{@@ -774,20 +882,25 @@ Gunakan bendera `--experimental-fetch` untuk melewati masalah terkait TLS:}```</details>+<details><summary><b>Kesalahan Umum Klien MCP</b></summary>+1. Coba tambahkan `@latest` ke nama paket2. Gunakan `bunx` sebagai alternatif `npx`3. Pertimbangkan menggunakan `deno` sebagai alternatif lain4. Pastikan Anda menggunakan Node.js v18 atau lebih tinggi untuk dukungan fetch native</details>+## ⚠️ PenafianProyek Context7 dikontribusikan oleh komunitas dan meskipun kami berusaha menjaga kualitas tinggi, kami tidak dapat menjamin keakuratan, kelengkapan, atau keamanan semua dokumentasi pustaka. Proyek yang terdaftar di Context7 dikembangkan dan dikelola oleh pemilik masing-masing, bukan oleh Context7. Jika Anda menemukan konten yang mencurigakan, tidak pantas, atau berpotensi membahayakan, gunakan tombol "Laporkan" di halaman proyek untuk segera memberi tahu kami. Kami memperlakukan semua laporan dengan serius dan akan segera meninjau konten yang dilaporkan untuk menjaga integritas dan keamanan platform kami. Dengan menggunakan Context7, Anda mengakui bahwa Anda melakukannya atas kebijaksanaan dan risiko Anda sendiri.+## 🤝 Terhubung dengan KamiTetap terbaru dan bergabunglah dengan komunitas kami:- 📢 Ikuti kami di [X](https://x.com/context7ai) untuk berita dan pembaruan terbaru- 🌐 Kunjungi [Situs Web](https://context7.com) kami- 💬 Bergabunglah dengan [Komunitas Discord](https://upstash.com/discord) kami+## 📺 Context7 Di 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)@@ -797,7 +910,9 @@ Tetap terbaru dan bergabunglah dengan komunitas kami:- [Income Stream Surfers: "Context7: The New MCP Server That Will CHANGE AI Coding"](https://www.youtube.com/watch?v=PS-2Azb-C3M)- [AICodeKing: "Context7 + Cline & RooCode: This MCP Server Makes CLINE 100X MORE EFFECTIVE!"](https://www.youtube.com/watch?v=qZfENAPMnyo)- [Sean Kochel: "5 MCP Servers For Vibe Coding Glory (Just Plug-In & Go)"](https://www.youtube.com/watch?v=LqTQi8qexJM)+## ⭐ Sejarah Bintang[](https://www.star-history.com/#upstash/context7&Date)+## 📄 LisensiMITdiff --git a/i18n/README.it.md b/i18n/README.it.mdindex 97baa0cb..ada01ea9 100644--- a/i18n/README.it.md+++ b/i18n/README.it.md@@ -64,6 +64,7 @@ Incollare la seguente configurazione nel file `~/.cursor/mcp.json` di Cursor è<details><summary>Alternativa: Usa Bun</summary>+```json{"mcpServers": {@@ -75,8 +76,10 @@ Incollare la seguente configurazione nel file `~/.cursor/mcp.json` di Cursor è}```</details>+<details><summary>Alternativa: Usa Deno</summary>+```json{"mcpServers": {@@ -88,6 +91,7 @@ Incollare la seguente configurazione nel file `~/.cursor/mcp.json` di Cursor è}```</details>+### Installare in WindsurfAggiungi questo al tuo file di configurazione Windsurf MCP. Vedi [Windsurf MCP docs](https://docs.windsurf.com/windsurf/mcp) per ulteriori informazioni.```json@@ -100,6 +104,7 @@ Aggiungi questo al tuo file di configurazione Windsurf MCP. Vedi [Windsurf MCP d}}```+### 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)@@ -115,6 +120,7 @@ Aggiungi questo al tuo file di configurazione MCP di VS Code. Vedi [VS Code MCP}}```+### Installare in ZedPuò 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@@ -128,11 +134,13 @@ Può essere installato tramite [Zed Extensions](https://zed.dev/extensions?query}}```+### Installare in Claude CodeEsegui questo comando. Vedi [Claude Code MCP docs](https://docs.anthropic.com/it/docs/claude-code/mcp) per ulteriori informazioni.```shclaude mcp add context7 -- npx -y @upstash/context7-mcp@latest```+### Installare in Claude DesktopAggiungi 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@@ -145,6 +153,7 @@ Aggiungi questo al tuo file `claude_desktop_config.json` di Claude Desktop. Vedi}}```+### Installazione in Copilot Coding AgentAggiungi la seguente configurazione alla sezione `mcp` del file di configurazione di Copilot Coding Agent (Repository->Settings->Copilot->Coding agent->MCP configuration):```json@@ -159,6 +168,7 @@ Aggiungi la seguente configurazione alla sezione `mcp` del file di configurazion}```Per maggiori informazioni, consulta la [documentazione ufficiale GitHub](https://docs.github.com/en/enterprise-cloud@latest/copilot/how-tos/agents/copilot-coding-agent/extending-copilot-coding-agent-with-mcp).+### Installazione in Copilot CLI1. 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`:@@ -190,12 +200,14 @@ Oppure, per un server locale:}```Se il file `mcp-config.json` non esiste, crealo.+### Utilizzo di DockerSe 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>+```DockerfileFROM node:18-alpineWORKDIR /app@@ -207,6 +219,7 @@ Se preferisci eseguire il server MCP in un contenitore Docker: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`:```bashdocker build -t context7-mcp .@@ -229,6 +242,7 @@ Se preferisci eseguire il server MCP in un contenitore Docker:}```_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)@@ -236,6 +250,7 @@ Se preferisci eseguire il server MCP in un contenitore Docker:- `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+## SviluppoClona il progetto e installa le dipendenze:```bash@@ -245,6 +260,7 @@ Compila:```bashpnpm run build```+### Esempio di Configurazione Locale```json{@@ -256,11 +272,14 @@ pnpm run build}}```+### Test con MCP Inspector```bashnpx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp@latest```+## Risoluzione dei problemi+### ERR_MODULE_NOT_FOUNDSe vedi questo errore, prova a usare `bunx` invece di `npx`.```json@@ -274,6 +293,7 @@ Se vedi questo errore, prova a usare `bunx` invece di `npx`.}```Questo spesso risolve i problemi di risoluzione dei moduli, specialmente negli ambienti dove `npx` non installa o risolve correttamente i pacchetti.+### Problemi di risoluzione ESMSe riscontri un errore come: `Error: Cannot find module 'uriTemplate.js'` prova a eseguire con il flag `--experimental-vm-modules`:```json@@ -286,13 +306,16 @@ Se riscontri un errore come: `Error: Cannot find module 'uriTemplate.js'` prova}}```+### Errori del Client MCP1. 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)@@ -300,7 +323,9 @@ I progetti Context7 sono contributi della comunità e, sebbene ci impegniamo a m- [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)+## LicenzaMITdiff --git a/i18n/README.ja.md b/i18n/README.ja.mdindex b1401867..d4bfe6c7 100644--- a/i18n/README.ja.md+++ b/i18n/README.ja.md@@ -43,6 +43,7 @@ Context7 は最新のコード例とドキュメントを直接 LLM のコンテ- Cursor、Windsurf、Claude Desktop またはその他の MCP クライアント<details><summary><b>Smithery 経由でのインストール</b></summary>+[Smithery](https://smithery.ai/server/@upstash/context7-mcp) 経由で任意のクライアントに Context7 MCP サーバーを自動的にインストールするには:```bash@@ -52,11 +53,14 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>Smithery キーは [Smithery.ai Web ページ](https://smithery.ai/server/@upstash/context7-mcp) で確認できます。</details>+<details><summary><b>Cursor へのインストール</b></summary>+`Settings` -> `Cursor Settings` -> `MCP` -> `Add new global MCP server` に移動します以下の設定を Cursor の `~/.cursor/mcp.json` ファイルに貼り付けることが推奨されます。プロジェクトフォルダに `.cursor/mcp.json` を作成することで、特定のプロジェクトにインストールすることもできます。詳細は [Cursor MCP ドキュメント](https://docs.cursor.com/context/model-context-protocol) を参照してください。> Cursor 1.0 以降、下のインストールボタンをクリックすることで、ワンクリックで即座にインストールできます。+#### Cursor リモートサーバー接続[](https://cursor.com/install-mcp?name=context7&config=eyJ1cmwiOiJodHRwczovL21jcC5jb250ZXh0Ny5jb20vbWNwIn0%3D)```json@@ -68,6 +72,7 @@ Smithery キーは [Smithery.ai Web ページ](https://smithery.ai/server/@upsta}}```+#### Cursor ローカルサーバー接続[](https://cursor.com/install-mcp?name=context7&config=eyJjb21tYW5kIjoibnB4IC15IEB1cHN0YXNoL2NvbnRleHQ3LW1jcCJ9)```json@@ -82,6 +87,7 @@ Smithery キーは [Smithery.ai Web ページ](https://smithery.ai/server/@upsta```<details><summary>代替方法:Bun を使用</summary>+[](https://cursor.com/install-mcp?name=context7&config=eyJjb21tYW5kIjoiYnVueCAteSBAdXBzdGFzaC9jb250ZXh0Ny1tY3AifQ%3D%3D)```json{@@ -94,8 +100,10 @@ Smithery キーは [Smithery.ai Web ページ](https://smithery.ai/server/@upsta}```</details>+<details><summary>代替方法:Deno を使用</summary>+[](https://cursor.com/install-mcp?name=context7&config=eyJjb21tYW5kIjoiZGVubyBydW4gLS1hbGxvdy1lbnYgLS1hbGxvdy1uZXQgbnBtOkB1cHN0YXNoL2NvbnRleHQ3LW1jcCJ9)```json{@@ -113,11 +121,16 @@ Smithery キーは [Smithery.ai Web ページ](https://smithery.ai/server/@upsta}```</details>+</details>+<details><summary><b>Windsurf へのインストール</b></summary>+これを Windsurf MCP 設定ファイルに追加します。詳細は [Windsurf MCP ドキュメント](https://docs.windsurf.com/windsurf/mcp) を参照してください。+#### Windsurf リモートサーバー接続+```json{"mcpServers": {@@ -127,7 +140,9 @@ Smithery キーは [Smithery.ai Web ページ](https://smithery.ai/server/@upsta}}```+#### Windsurf ローカルサーバー接続+```json{"mcpServers": {@@ -139,12 +154,16 @@ Smithery キーは [Smithery.ai Web ページ](https://smithery.ai/server/@upsta}```</details>+<details><summary><b>VS Code へのインストール</b></summary>+[<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)[<img alt="Install in VS Code Insiders (npx)" src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Install%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)これを VS Code MCP 設定ファイルに追加します。詳細は [VS Code MCP ドキュメント](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) を参照してください。+#### VS Code リモートサーバー接続+```json"mcp": {"servers": {@@ -155,7 +174,9 @@ Smithery キーは [Smithery.ai Web ページ](https://smithery.ai/server/@upsta}}```+#### VS Code ローカルサーバー接続+```json"mcp": {"servers": {@@ -168,10 +189,12 @@ Smithery キーは [Smithery.ai Web ページ](https://smithery.ai/server/@upsta}```</details>+<details><summary><b>Cline でのインストール</b></summary>+1. **Cline** を開きます。2. メニューアイコン (☰) をクリックし、**MCP サーバー**セクションに移動します。3. **リモートサーバー** タブを選択します。@@ -191,8 +214,10 @@ Smithery キーは [Smithery.ai Web ページ](https://smithery.ai/server/@upsta}```</details>+<details><summary><b>Visual Studio 2022 へのインストール</b></summary>+[Visual Studio MCP サーバードキュメント](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022) に従って、Visual Studio 2022 で Context7 MCP を設定できます。これを Visual Studio MCP 設定ファイルに追加します(詳細は [Visual Studio ドキュメント](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022) を参照):```json@@ -223,8 +248,10 @@ Smithery キーは [Smithery.ai Web ページ](https://smithery.ai/server/@upsta```詳細情報とトラブルシューティングについては、[Visual Studio MCP サーバードキュメント](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022) を参照してください。</details>+<details><summary><b>Zed へのインストール</b></summary>+[Zed Extensions](https://zed.dev/extensions?query=Context7) 経由でインストールできるか、Zed の `settings.json` にこれを追加できます。詳細は [Zed Context Server ドキュメント](https://zed.dev/docs/assistant/context-servers) を参照してください。```json{@@ -238,20 +265,28 @@ Smithery キーは [Smithery.ai Web ページ](https://smithery.ai/server/@upsta}```</details>+<details><summary><b>Claude Code へのインストール</b></summary>+このコマンドを実行します。詳細は [Claude Code MCP ドキュメント](https://docs.anthropic.com/ja/docs/claude-code/mcp) を参照してください。+#### Claude Code ローカルサーバー接続+```shclaude mcp add context7 -- npx -y @upstash/context7-mcp```+#### Claude Code リモートサーバー接続+```shclaude mcp add --transport http context7 https://mcp.context7.com/mcp```</details>+<details><summary><b>Claude Desktop へのインストール</b></summary>+これを Claude Desktop の `claude_desktop_config.json` ファイルに追加します。詳細は [Claude Desktop MCP ドキュメント](https://modelcontextprotocol.io/quickstart/user) を参照してください。```json{@@ -264,8 +299,10 @@ claude mcp add --transport http context7 https://mcp.context7.com/mcp}```</details>+<details><summary><b>BoltAI へのインストール</b></summary>+アプリの "Settings" ページを開き、"Plugins" に移動し、以下の JSON を入力します:```json{@@ -279,8 +316,10 @@ claude mcp add --transport http context7 https://mcp.context7.com/mcp```保存後、チャットで `query-docs` の後に Context7 ドキュメント ID を入力します(例:`query-docs /nuxt/ui`)。詳細情報は [BoltAI ドキュメンテーションサイト](https://docs.boltai.com/docs/plugins/mcp-servers) で利用可能です。iOS 版 BoltAI については、[このガイドを参照してください](https://docs.boltai.com/docs/boltai-mobile/mcp-servers)。</details>+<details><summary><b>Copilot Coding Agent へのインストール</b></summary>+以下の設定を Copilot Coding Agent の `mcp` セクション(Repository->Settings->Copilot->Coding agent->MCP configuration)に追加してください:```json{@@ -295,8 +334,10 @@ claude mcp add --transport http context7 https://mcp.context7.com/mcp```詳細は [公式 GitHub ドキュメント](https://docs.github.com/en/enterprise-cloud@latest/copilot/how-tos/agents/copilot-coding-agent/extending-copilot-coding-agent-with-mcp) をご覧ください。</details>+<details><summary><b>Copilot CLI へのインストール</b></summary>+1. Copilot CLI MCP 設定ファイルを開きます。ファイルの場所は `~/.copilot/mcp-config.json`(`~` はホームディレクトリ)です。2. `mcp-config.json` ファイルの `mcpServers` オブジェクトに以下を追加します:```json@@ -328,13 +369,16 @@ claude mcp add --transport http context7 https://mcp.context7.com/mcp````mcp-config.json` ファイルが存在しない場合は、作成してください。</details>+<details><summary><b>Docker を使用</b></summary>+MCP サーバーを Docker コンテナで実行したい場合:1. **Docker イメージのビルド:**まず、プロジェクトルート(または希望の場所)に `Dockerfile` を作成します:<details><summary>Dockerfile の内容を表示</summary>+```DockerfileFROM node:18-alpineWORKDIR /app@@ -346,6 +390,7 @@ MCP サーバーを Docker コンテナで実行したい場合:CMD ["context7-mcp"]```</details>+次に、タグ(例:`context7-mcp`)を使用してイメージをビルドします。**Docker Desktop(または Docker デーモン)が実行中であることを確認してください。** `Dockerfile` を保存した同じディレクトリで次のコマンドを実行します:```bashdocker build -t context7-mcp .@@ -369,8 +414,10 @@ MCP サーバーを Docker コンテナで実行したい場合:```_注:これは設定例です。この README の前半で MCP クライアント(Cursor、VS Code など)の具体的な例を参照して、構造(例:`mcpServers` 対 `servers`)を適応させてください。また、`args` 内のイメージ名が `docker build` コマンドで使用したタグと一致していることを確認してください。_</details>+<details><summary><b>Windows へのインストール</b></summary>+Windows での設定は Linux や macOS と比べて少し異なります(_例では `Cline` を使用_)。同じ原則が他のエディタにも適用されます。`command` と `args` の設定を参照してください。```json{@@ -385,9 +432,12 @@ Windows での設定は Linux や macOS と比べて少し異なります(_例}```</details>+<details><summary><b>Augment Code へのインストール</b></summary>+Augment Code で Context7 MCP を設定するには、グラフィカルインターフェースまたは手動設定のいずれかを使用できます。+### **A. Augment Code UI を使用する場合**1. ハンバーガーメニューをクリックします。2. **Settings** を選択します。@@ -401,6 +451,7 @@ Augment Code で Context7 MCP を設定するには、グラフィカルイン7. **Add** ボタンをクリックします。MCP サーバーが追加されたら、Augment Code 内で Context7 の最新コードドキュメンテーション機能を直接使用できます。---+### **B. 手動設定**1. Cmd/Ctrl Shift P を押すか、Augment パネルのハンバーガーメニューに移動します2. Edit Settings を選択します@@ -417,10 +468,14 @@ MCP サーバーが追加されたら、Augment Code 内で Context7 の最新}MCP サーバーが追加されたら、エディタを再起動します。エラーが発生した場合は、構文をチェックして、閉じ括弧やカンマが欠けていないことを確認してください。</details>+<details><summary><b>Roo Code へのインストール</b></summary>+これを Roo Code MCP 設定ファイルに追加します。詳細は [Roo Code MCP ドキュメント](https://docs.roocode.com/features/mcp/using-mcp-in-roo) を参照してください。+#### Roo Code リモートサーバー接続+```json{"mcpServers": {@@ -431,7 +486,9 @@ MCP サーバーが追加されたら、エディタを再起動します。エ}}```+#### Roo Code ローカルサーバー接続+```json{"mcpServers": {@@ -443,8 +500,10 @@ MCP サーバーが追加されたら、エディタを再起動します。エ}```</details>+<details><summary><b>Zencoder へのインストール</b></summary>+Zencoder で Context7 MCP を設定するには、以下の手順に従います:1. Zencoder メニュー (...) に移動します2. ドロップダウンメニューから Agent tools を選択します@@ -458,8 +517,10 @@ Zencoder で Context7 MCP を設定するには、以下の手順に従います```MCP サーバーが追加されたら、簡単に使用を続けることができます。</details>+<details><summary><b>Amazon Q Developer CLI へのインストール</b></summary>+これを Amazon Q Developer CLI 設定ファイルに追加します。詳細は [Amazon Q Developer CLI ドキュメント](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-configuration.html) を参照してください。```json{@@ -472,6 +533,7 @@ MCP サーバーが追加されたら、簡単に使用を続けることがで}```</details>+## 🔨 利用可能なツールContext7 MCP は LLM が使用できる以下のツールを提供します:- `resolve-library-id`:一般的なライブラリ名を Context7 互換のライブラリ ID に変換します。@@ -480,6 +542,7 @@ Context7 MCP は LLM が使用できる以下のツールを提供します:- `query-docs`:Context7 互換のライブラリ ID を使用してライブラリのドキュメントを取得します。- `libraryId`(必須):正確な Context7 互換のライブラリ ID(例:`/mongodb/docs`、`/vercel/next.js`)- `query`(必須):関連するドキュメントを取得するための質問またはタスク+## 💻 開発プロジェクトをクローンして依存関係をインストールします:```bash@@ -493,6 +556,7 @@ pnpm run build```bashnode packages/mcp/dist/index.js```+### CLI 引数`context7-mcp` は以下の CLI フラグを受け付けます:- `--transport <stdio|http>` – 使用するトランスポート(デフォルトは `stdio`)。@@ -503,6 +567,7 @@ node packages/mcp/dist/index.js --transport http --port 8080```<details><summary><b>ローカル設定例</b></summary>+```json{"mcpServers": {@@ -514,15 +579,19 @@ node packages/mcp/dist/index.js --transport http --port 8080}```</details>+<details><summary><b>MCP Inspector でのテスト</b></summary>+```bashnpx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp```</details>+## 🚨 トラブルシューティング<details><summary><b>モジュールが見つからないエラー</b></summary>+`ERR_MODULE_NOT_FOUND` が発生した場合は、`npx` の代わりに `bunx` を使用してみてください:```json{@@ -536,8 +605,10 @@ npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp```これにより、`npx` がパッケージを正しくインストールまたは解決できない環境でのモジュール解決の問題が解決されることがあります。</details>+<details><summary><b>ESM 解決の問題</b></summary>+`Error: Cannot find module 'uriTemplate.js'` のようなエラーの場合は、`--experimental-vm-modules` フラグを試してください:```json{@@ -550,8 +621,10 @@ npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp}```</details>+<details><summary><b>TLS/証明書の問題</b></summary>+TLS 関連の問題を回避するには、`--experimental-fetch` フラグを使用します:```json{@@ -564,20 +637,25 @@ TLS 関連の問題を回避するには、`--experimental-fetch` フラグを}```</details>+<details><summary><b>一般的な MCP クライアントエラー</b></summary>+1. パッケージ名に `@latest` を追加してみる2. `npx` の代替として `bunx` を使用する3. 別の代替方法として `deno` の使用を検討する4. ネイティブ fetch サポートのために Node.js v18 以上を使用していることを確認する</details>+## ⚠️ 免責事項Context7 プロジェクトはコミュニティが貢献しているもので、高品質を維持するよう努めていますが、すべてのライブラリドキュメントの正確性、完全性、セキュリティを保証することはできません。Context7 にリストされているプロジェクトは、Context7 ではなく、それぞれの所有者によって開発および保守されています。疑わしい、不適切な、または潜在的に有害なコンテンツを発見した場合は、プロジェクトページの「報告」ボタンを使用して、すぐにお知らせください。私たちはすべての報告を真剣に受け止め、プラットフォームの整合性と安全性を維持するために、フラグが付けられたコンテンツを迅速にレビューします。Context7 を使用することにより、あなたは自己の裁量とリスクで使用することを認めます。+## 🤝 私たちとつながる最新情報を入手し、コミュニティに参加しましょう:- 📢 最新ニュースとアップデートのために [X](https://x.com/contextai) でフォローしてください- 🌐 [Web サイト](https://context7.com) を訪問してください- 💬 [Discord コミュニティ](https://upstash.com/discord) に参加してください+## 📺 メディアでの Context7- [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)@@ -587,7 +665,9 @@ Context7 プロジェクトはコミュニティが貢献しているもので- [Income Stream Surfers: "Context7: The New MCP Server That Will CHANGE AI Coding"](https://www.youtube.com/watch?v=PS-2Azb-C3M)- [AICodeKing: "Context7 + Cline & RooCode: This MCP Server Makes CLINE 100X MORE EFFECTIVE!"](https://www.youtube.com/watch?v=qZfENAPMnyo)- [Sean Kochel: "5 MCP Servers For Vibe Coding Glory (Just Plug-In & Go)"](https://www.youtube.com/watch?v=LqTQi8qexJM)+## ⭐ スター履歴[](https://www.star-history.com/#upstash/context7&Date)+## 📄 ライセンスMITdiff --git a/i18n/README.pt-BR.md b/i18n/README.pt-BR.mdindex abdfd105..8dfb156b 100644--- a/i18n/README.pt-BR.md+++ b/i18n/README.pt-BR.md@@ -44,6 +44,7 @@ Confira nosso [guia de adição de projetos](./adding-projects.md) para aprender- Cursor, Claude Code, VSCode, Windsurf ou outro Cliente MCP<details><summary><b>Instalando via Smithery</b></summary>+Para instalar o Context7 MCP Server automaticamente em qualquer cliente via [Smithery](https://smithery.ai/server/@upstash/context7-mcp):```bash@@ -53,11 +54,14 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>Você pode encontrar sua chave Smithery na [página do Smithery.ai](https://smithery.ai/server/@upstash/context7-mcp).</details>+<details><summary><b>Instalar no Cursor</b></summary>+Vá em: `Settings` -> `Cursor Settings` -> `MCP` -> `Add new global MCP server`Colar a seguinte configuração no arquivo `~/.cursor/mcp.json` do Cursor é a abordagem recomendada. Você também pode instalar em um projeto específico criando `.cursor/mcp.json` na pasta do seu projeto. Veja mais em [Cursor MCP docs](https://docs.cursor.com/context/model-context-protocol).> Desde o Cursor 1.0, você pode clicar no botão de instalar abaixo para uma instalação instantânea com um clique.+#### Conexão Remota do Servidor Cursor[](https://cursor.com/en/install-mcp?name=context7&config=eyJ1cmwiOiJodHRwczovL21jcC5jb250ZXh0Ny5jb20vbWNwIn0%3D)```json@@ -69,6 +73,7 @@ Colar a seguinte configuração no arquivo `~/.cursor/mcp.json` do Cursor é a a}}```+#### Conexão Local do Servidor Cursor[](https://cursor.com/en/install-mcp?name=context7&config=eyJjb21tYW5kIjoibnB4IC15IEB1cHN0YXNoL2NvbnRleHQ3LW1jcCJ9)```json@@ -82,22 +87,32 @@ Colar a seguinte configuração no arquivo `~/.cursor/mcp.json` do Cursor é a a}```</details>+<details><summary><b>Instalar no Claude Code</b></summary>+Execute este comando. Veja mais em [Claude Code MCP docs](https://docs.anthropic.com/pt/docs/claude-code/mcp).+#### Conexão Local do Servidor Claude Code+```shclaude mcp add context7 -- npx -y @upstash/context7-mcp```+#### Conexão Remota do Servidor Claude Code+```shclaude mcp add --transport http context7 https://mcp.context7.com/mcp```</details>+<details><summary><b>Instalar no Windsurf</b></summary>+Adicione isto ao arquivo de configuração MCP do Windsurf. Veja mais em [Windsurf MCP docs](https://docs.windsurf.com/windsurf/cascade/mcp).+#### Conexão Remota do Servidor Windsurf+```json{"mcpServers": {@@ -107,7 +122,9 @@ Adicione isto ao arquivo de configuração MCP do Windsurf. Veja mais em [Windsu}}```+#### Conexão Local do Servidor Windsurf+```json{"mcpServers": {@@ -119,12 +136,16 @@ Adicione isto ao arquivo de configuração MCP do Windsurf. Veja mais em [Windsu}```</details>+<details><summary><b>Instalar no VS Code</b></summary>+[<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)[<img alt="Install in VS Code Insiders (npx)" src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Install%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)Adicione isto ao arquivo de configuração MCP do VS Code. Veja mais em [VS Code MCP docs](https://code.visualstudio.com/docs/copilot/chat/mcp-servers).+#### Conexão Remota do Servidor VS Code+```json"mcp": {"servers": {@@ -135,7 +156,9 @@ Adicione isto ao arquivo de configuração MCP do VS Code. Veja mais em [VS Code}}```+#### Conexão Local do Servidor VS Code+```json"mcp": {"servers": {@@ -148,18 +171,22 @@ Adicione isto ao arquivo de configuração MCP do VS Code. Veja mais em [VS Code}```</details>+<details><summary><b>Instalar no Cline</b></summary>+Você pode instalar o Context7 facilmente pelo [Cline MCP Server Marketplace](https://cline.bot/mcp-marketplace) seguindo estas instruções:1. Abra o **Cline**.2. Clique no ícone de menu (☰) para entrar na seção **MCP Servers**.3. Use a barra de busca na aba **Marketplace** para encontrar _Context7_.4. Clique no botão **Install**.</details>+<details><summary><b>Instalar no Zed</b></summary>+Pode ser instalado via [Zed Extensions](https://zed.dev/extensions?query=Context7) ou você pode adicionar isto ao seu `settings.json` do Zed. Veja mais em [Zed Context Server docs](https://zed.dev/docs/assistant/context-servers).```json{@@ -173,9 +200,12 @@ Pode ser instalado via [Zed Extensions](https://zed.dev/extensions?query=Context}```</details>+<details><summary><b>Instalar no Augment Code</b></summary>+Para configurar o Context7 MCP no Augment Code, você pode usar a interface gráfica ou a configuração manual.+### **A. Usando a UI do Augment Code**1. Clique no menu hambúrguer.2. Selecione **Settings**.@@ -189,6 +219,7 @@ Para configurar o Context7 MCP no Augment Code, você pode usar a interface grá7. Clique no botão **Add**.Depois que o servidor MCP for adicionado, você pode começar a usar os recursos de documentação de código atualizada do Context7 diretamente no Augment Code.---+### **B. Configuração Manual**1. Pressione Cmd/Ctrl Shift P ou vá ao menu hambúrguer no painel do Augment2. Selecione Edit Settings@@ -207,10 +238,14 @@ Depois que o servidor MCP for adicionado, você pode começar a usar os recursos```Depois de adicionar o servidor MCP, reinicie seu editor. Se você receber algum erro, verifique a sintaxe para garantir que colchetes ou vírgulas não estejam faltando.</details>+<details><summary><b>Instalar no Roo Code</b></summary>+Adicione isto ao arquivo de configuração MCP do Roo Code. Veja mais em [Roo Code MCP docs](https://docs.roocode.com/features/mcp/using-mcp-in-roo).+#### Conexão Remota do Servidor Roo Code+```json{"mcpServers": {@@ -221,7 +256,9 @@ Adicione isto ao arquivo de configuração MCP do Roo Code. Veja mais em [Roo Co}}```+#### Conexão Local do Servidor Roo Code+```json{"mcpServers": {@@ -233,8 +270,10 @@ Adicione isto ao arquivo de configuração MCP do Roo Code. Veja mais em [Roo Co}```</details>+<details><summary><b>Instalar no Gemini CLI</b></summary>+Veja os detalhes em [Configuração do Gemini CLI](https://google-gemini.github.io/gemini-cli/docs/tools/mcp-server.html).1. Abra o arquivo de configurações do Gemini CLI. A localização é `~/.gemini/settings.json` (onde `~` é o seu diretório home).2. Adicione o seguinte ao objeto `mcpServers` no seu arquivo `settings.json`:@@ -260,10 +299,13 @@ Ou, para um servidor local:```Se o objeto `mcpServers` não existir, crie-o.</details>+<details><summary><b>Instalar no Claude Desktop</b></summary>+#### Conexão RemotaAbra o Claude Desktop e navegue até Settings > Connectors > Add Custom Connector. Insira o nome como `Context7` e a URL remota do MCP server como `https://mcp.context7.com/mcp`.+#### Conexão LocalAbra as configurações de desenvolvedor do Claude Desktop e edite seu arquivo `claude_desktop_config.json` para adicionar a seguinte configuração. Veja mais em [Claude Desktop MCP docs](https://modelcontextprotocol.io/quickstart/user).```json@@ -277,10 +319,14 @@ Abra as configurações de desenvolvedor do Claude Desktop e edite seu arquivo `}```</details>+<details><summary><b>Instalar no Opencode</b></summary>+Adicione isto ao arquivo de configuração do Opencode. Veja mais em [Opencode MCP docs](https://opencode.ai/docs/mcp-servers).+#### Conexão Remota do Opencode+```json"mcp": {"context7": {@@ -290,7 +336,9 @@ Adicione isto ao arquivo de configuração do Opencode. Veja mais em [Opencode M}}```+#### Conexão Local do Opencode+```json{"mcp": {@@ -303,25 +351,33 @@ Adicione isto ao arquivo de configuração do Opencode. Veja mais em [Opencode M}```</details>+<details><summary><b>Instalar no OpenAI Codex</b></summary>+Veja mais em [OpenAI Codex](https://github.com/openai/codex).Adicione a seguinte configuração às definições do servidor MCP do OpenAI Codex:+#### Conexão de Servidor Local+```toml[mcp_servers.context7]args = ["-y", "@upstash/context7-mcp"]command = "npx"```+#### Conexão de Servidor Remoto+```toml[mcp_servers.context7]url = "https://mcp.context7.com/mcp"http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }```</details>+<details><summary><b>Instalar no JetBrains AI Assistant</b></summary>+Veja mais detalhes na [Documentação do JetBrains AI Assistant](https://www.jetbrains.com/help/ai-assistant/configure-an-mcp-server.html).1. Nos IDEs da JetBrains vá em `Settings` -> `Tools` -> `AI Assistant` -> `Model Context Protocol (MCP)`2. Clique em `+ Add`.@@ -340,8 +396,10 @@ Veja mais detalhes na [Documentação do JetBrains AI Assistant](https://www.jet5. Clique em `Apply` para salvar as alterações.6. Da mesma forma, o context7 pode ser adicionado ao JetBrains Junie em `Settings` -> `Tools` -> `Junie` -> `MCP Settings`</details>+<details><summary><b>Instalar no Kiro</b></summary>+Veja a [Documentação do Kiro Model Context Protocol](https://kiro.dev/docs/mcp/configuration/) para detalhes.1. Navegue até `Kiro` > `MCP Servers`2. Adicione um novo servidor MCP clicando no botão `+ Add`.@@ -361,11 +419,15 @@ Veja a [Documentação do Kiro Model Context Protocol](https://kiro.dev/docs/mcp```4. Clique em `Save` para aplicar as alterações.</details>+<details><summary><b>Instalar no Trae</b></summary>+Use o recurso Add manually e preencha as informações de configuração JSON para esse servidor MCP.Para mais detalhes, visite a [documentação do Trae](https://docs.trae.ai/ide/model-context-protocol?_lang=en).+#### Conexão Remota do Servidor Trae+```json{"mcpServers": {@@ -375,7 +437,9 @@ Para mais detalhes, visite a [documentação do Trae](https://docs.trae.ai/ide/m}}```+#### Conexão Local do Servidor Trae+```json{"mcpServers": {@@ -387,10 +451,14 @@ Para mais detalhes, visite a [documentação do Trae](https://docs.trae.ai/ide/m}```</details>+<details><summary><b>Usando Bun ou Deno</b></summary>+Use estas alternativas para executar o servidor Context7 MCP local com outros runtimes. Esses exemplos funcionam para qualquer cliente que suporte iniciar um servidor MCP local via command + args.+#### Bun+```json{"mcpServers": {@@ -401,7 +469,9 @@ Use estas alternativas para executar o servidor Context7 MCP local com outros ru}}```+#### Deno+```json{"mcpServers": {@@ -418,13 +488,16 @@ Use estas alternativas para executar o servidor Context7 MCP local com outros ru}```</details>+<details><summary><b>Usando Docker</b></summary>+Se preferir executar o servidor MCP em um contêiner Docker:1. **Crie a Imagem Docker:**Primeiro, crie um `Dockerfile` na raiz do projeto (ou onde preferir):<details><summary>Clique para ver o conteúdo do Dockerfile</summary>+```DockerfileFROM node:18-alpineWORKDIR /app@@ -436,6 +509,7 @@ Se preferir executar o servidor MCP em um contêiner Docker:CMD ["context7-mcp"]```</details>+Em seguida, construa a imagem usando uma tag (por exemplo, `context7-mcp`). **Certifique-se de que o Docker Desktop (ou o daemon Docker) esteja em execução.** Execute o comando abaixo no mesmo diretório onde você salvou o `Dockerfile`:```bashdocker build -t context7-mcp .@@ -459,12 +533,16 @@ Se preferir executar o servidor MCP em um contêiner Docker:```_Nota: Este é um exemplo de configuração. Consulte os exemplos específicos do seu cliente MCP (como Cursor, VS Code, etc.) anteriormente neste README para adaptar a estrutura (por exemplo, `mcpServers` vs `servers`). Além disso, garanta que o nome da imagem em `args` corresponda à tag usada durante o comando `docker build`._</details>+<details><summary><b>Instalar Usando a Extensão Desktop</b></summary>+Instale o arquivo [context7.dxt](dxt/context7.dxt) na pasta dxt e adicione-o ao seu cliente. Para mais informações, confira a [documentação de desktop extensions](https://github.com/anthropics/dxt#desktop-extensions-dxt).</details>+<details><summary><b>Instalar no Windows</b></summary>+A configuração no Windows é um pouco diferente em comparação ao Linux ou macOS (_`Cline` é usado no exemplo_). O mesmo princípio se aplica a outros editores; consulte a configuração de `command` e `args`.```json{@@ -479,8 +557,10 @@ A configuração no Windows é um pouco diferente em comparação ao Linux ou ma}```</details>+<details><summary><b>Instalar no Amazon Q Developer CLI</b></summary>+Adicione isto ao arquivo de configuração do Amazon Q Developer CLI. Veja mais em [documentação do Amazon Q Developer CLI](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-configuration.html).```json{@@ -493,8 +573,10 @@ Adicione isto ao arquivo de configuração do Amazon Q Developer CLI. Veja mais}```</details>+<details><summary><b>Instalar no Warp</b></summary>+Veja mais em [Documentação do Warp Model Context Protocol](https://docs.warp.dev/knowledge-and-collaboration/mcp#adding-an-mcp-server).1. Vá em `Settings` > `AI` > `Manage MCP servers`.2. Adicione um novo servidor MCP clicando no botão `+ Add`.@@ -512,8 +594,10 @@ Veja mais em [Documentação do Warp Model Context Protocol](https://docs.warp.d```4. Clique em `Save` para aplicar as alterações.</details>+<details><summary><b>Instalar no Copilot Coding Agent</b></summary>+## Usando o Context7 com o Copilot Coding AgentAdicione a seguinte configuração à seção `mcp` do arquivo de configuração do seu Copilot Coding Agent Repository->Settings->Copilot->Coding agent->MCP configuration:```json@@ -529,8 +613,10 @@ Adicione a seguinte configuração à seção `mcp` do arquivo de configuração```Para mais informações, veja a [documentação oficial do GitHub](https://docs.github.com/en/enterprise-cloud@latest/copilot/how-tos/agents/copilot-coding-agent/extending-copilot-coding-agent-with-mcp).</details>+<details><summary><b>Instalar no Copilot CLI</b></summary>+1. Abra o arquivo de configuração MCP do Copilot CLI. A localização é `~/.copilot/mcp-config.json` (onde `~` é o seu diretório home).2. Adicione o seguinte ao objeto `mcpServers` no seu arquivo `mcp-config.json`:```json@@ -562,11 +648,15 @@ Ou, para um servidor local:```Se o arquivo `mcp-config.json` não existir, crie-o.</details>+<details><summary><b>Instalar no LM Studio</b></summary>+Veja mais em [Suporte a MCP no LM Studio](https://lmstudio.ai/blog/lmstudio-v0.3.17).+#### Instalação com um clique:[](https://lmstudio.ai/install-mcp?name=context7&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkB1cHN0YXNoL2NvbnRleHQ3LW1jcCJdfQ%3D%3D)+#### Configuração manual:1. Navegue até `Program` (lado direito) > `Install` > `Edit mcp.json`.2. Cole a configuração abaixo:@@ -583,8 +673,10 @@ Veja mais em [Suporte a MCP no LM Studio](https://lmstudio.ai/blog/lmstudio-v0.33. Clique em `Save` para aplicar as alterações.4. Ative/desative o servidor MCP no lado direito, em `Program`, ou clicando no ícone de plug na parte inferior da caixa de chat.</details>+<details><summary><b>Instalar no Visual Studio 2022</b></summary>+Você pode configurar o Context7 MCP no Visual Studio 2022 seguindo a [documentação de MCP Servers do Visual Studio](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022).Adicione isto ao arquivo de configuração MCP do Visual Studio (veja os [docs do Visual Studio](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022) para detalhes):```json@@ -615,10 +707,14 @@ Ou, para um servidor local:```Para mais informações e solução de problemas, consulte a [documentação de MCP Servers do Visual Studio](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022).</details>+<details><summary><b>Instalar no Crush</b></summary>+Adicione isto ao arquivo de configuração do Crush. Veja mais em [Crush MCP docs](https://github.com/charmbracelet/crush#mcps).+#### Conexão Remota do Crush+```json{"$schema": "https://charm.land/crush.json",@@ -630,7 +726,9 @@ Adicione isto ao arquivo de configuração do Crush. Veja mais em [Crush MCP doc}}```+#### Conexão Local do Crush+```json{"$schema": "https://charm.land/crush.json",@@ -644,8 +742,10 @@ Adicione isto ao arquivo de configuração do Crush. Veja mais em [Crush MCP doc}```</details>+<details><summary><b>Instalar no BoltAI</b></summary>+Abra a página "Settings" do app, navegue até "Plugins" e insira o seguinte JSON:```json{@@ -659,14 +759,18 @@ Abra a página "Settings" do app, navegue até "Plugins" e insira o seguinte JSO```Depois de salvar, digite no chat `query-docs` seguido do seu Context7 documentation ID (por exemplo, `query-docs /nuxt/ui`). Mais informações em [BoltAI's Documentation site](https://docs.boltai.com/docs/plugins/mcp-servers). Para o BoltAI no iOS, [veja este guia](https://docs.boltai.com/docs/boltai-mobile/mcp-servers).</details>+<details><summary><b>Instalar no Rovo Dev CLI</b></summary>+Edite sua configuração MCP do Rovo Dev CLI executando o comando abaixo -```bashacli rovodev mcp```Configuração de exemplo -+#### Conexão Remota+```json{"mcpServers": {@@ -676,7 +780,9 @@ Configuração de exemplo -}}```+#### Conexão Local+```json{"mcpServers": {@@ -688,8 +794,10 @@ Configuração de exemplo -}```</details>+<details><summary><b>Instalar no Zencoder</b></summary>+Para configurar o Context7 MCP no Zencoder, siga estes passos:1. Vá ao menu do Zencoder (...)2. No menu suspenso, selecione Agent tools@@ -703,14 +811,18 @@ Para configurar o Context7 MCP no Zencoder, siga estes passos:```Depois que o servidor MCP for adicionado, você pode continuar usando-o facilmente.</details>+<details><summary><b>Instalar no Qodo Gen</b></summary>+Veja mais em [docs do Qodo Gen](https://docs.qodo.ai/qodo-documentation/qodo-gen/qodo-gen-chat/agentic-mode/agentic-tools-mcps).1. Abra o painel de chat do Qodo Gen no VSCode ou IntelliJ.2. Clique em Connect more tools.3. Clique em + Add new MCP.4. Adicione a seguinte configuração:+#### Conexão Local do Qodo Gen+```json{"mcpServers": {@@ -721,7 +833,9 @@ Veja mais em [docs do Qodo Gen](https://docs.qodo.ai/qodo-documentation/qodo-gen}}```+#### Conexão Remota do Qodo Gen+```json{"mcpServers": {@@ -732,8 +846,10 @@ Veja mais em [docs do Qodo Gen](https://docs.qodo.ai/qodo-documentation/qodo-gen}```</details>+<details><summary><b>Instalar no Perplexity Desktop</b></summary>+Veja mais em [Local and Remote MCPs for Perplexity](https://www.perplexity.ai/help-center/en/articles/11502712-local-and-remote-mcps-for-perplexity).1. Vá em `Perplexity` > `Settings`2. Selecione `Connectors`.@@ -750,6 +866,7 @@ Veja mais em [Local and Remote MCPs for Perplexity](https://www.perplexity.ai/he```7. Clique em `Save`.</details>+## 🔨 Ferramentas DisponíveisO Context7 MCP fornece as seguintes ferramentas que LLMs podem usar:- `resolve-library-id`: Resolve um nome geral de biblioteca em um ID compatível com o Context7.@@ -758,7 +875,9 @@ O Context7 MCP fornece as seguintes ferramentas que LLMs podem usar:- `query-docs`: Busca documentação para uma biblioteca usando um ID compatível com o Context7.- `libraryId` (obrigatório): ID exato compatível com Context7 (por exemplo, `/mongodb/docs`, `/vercel/next.js`)- `query` (obrigatório): A pergunta ou tarefa para obter documentação relevante+## 🛟 Dicas+### Adicionar uma Regra> Se você não quiser adicionar `use context7` a todo prompt, você pode definir uma regra simples no seu arquivo `.windsurfrules` no Windsurf ou em `Cursor Settings > Rules` no Cursor (ou equivalente no seu cliente MCP) para invocar o Context7 automaticamente em qualquer questão de código:>@@ -769,6 +888,7 @@ O Context7 MCP fornece as seguintes ferramentas que LLMs podem usar:> ```>> A partir daí você receberá os docs do Context7 em qualquer conversa relacionada sem digitar nada extra. Você pode adicionar seus casos de uso na parte match.+### Usar o ID da Biblioteca> Se você já sabe exatamente qual biblioteca deseja usar, adicione o ID do Context7 ao seu prompt. Assim, o servidor MCP do Context7 pode pular a etapa de correspondência de biblioteca e ir direto para recuperar os docs.>@@ -777,6 +897,7 @@ O Context7 MCP fornece as seguintes ferramentas que LLMs podem usar:> ```>> A sintaxe com barra informa à ferramenta MCP exatamente qual biblioteca carregar.+## 💻 DesenvolvimentoClone o projeto e instale as dependências:```bash@@ -790,6 +911,7 @@ Execute o servidor:```bashnode packages/mcp/dist/index.js```+### Argumentos de CLI`context7-mcp` aceita as seguintes flags de CLI:- `--transport <stdio|http>` – Transporte a ser usado (`stdio` por padrão). Use `http` para servidor HTTP remoto ou `stdio` para integração local.@@ -804,6 +926,7 @@ node packages/mcp/dist/index.js --transport stdio```<details><summary><b>Exemplo de Configuração Local</b></summary>+```json{"mcpServers": {@@ -815,15 +938,19 @@ node packages/mcp/dist/index.js --transport stdio}```</details>+<details><summary><b>Testando com o MCP Inspector</b></summary>+```bashnpx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp```</details>+## 🚨 Solução de Problemas<details><summary><b>Erros de Módulo Não Encontrado</b></summary>+Se você encontrar `ERR_MODULE_NOT_FOUND`, tente usar `bunx` em vez de `npx`:```json{@@ -837,8 +964,10 @@ Se você encontrar `ERR_MODULE_NOT_FOUND`, tente usar `bunx` em vez de `npx`:```Isso frequentemente resolve problemas de resolução de módulos em ambientes onde o `npx` não instala ou resolve os pacotes corretamente.</details>+<details><summary><b>Problemas de Resolução ESM</b></summary>+Para erros como `Error: Cannot find module 'uriTemplate.js'`, tente a flag `--experimental-vm-modules`:```json{@@ -851,8 +980,10 @@ Para erros como `Error: Cannot find module 'uriTemplate.js'`, tente a flag `--ex}```</details>+<details><summary><b>Problemas de TLS/Certificados</b></summary>+Use a flag `--experimental-fetch` para contornar problemas relacionados a TLS:```json{@@ -865,20 +996,25 @@ Use a flag `--experimental-fetch` para contornar problemas relacionados a TLS:}```</details>+<details><summary><b>Erros Gerais do Cliente MCP</b></summary>+1. Tente adicionar `@latest` ao nome do pacote2. Use `bunx` como alternativa ao `npx`3. Considere usar `deno` como outra alternativa4. Certifique-se de estar usando Node.js v18 ou superior para suporte nativo a fetch</details>+## ⚠️ AvisoOs projetos do Context7 são contribuídos pela comunidade e, embora nos esforcemos para manter alta qualidade, não podemos garantir a precisão, integridade ou segurança de toda a documentação de bibliotecas. Os projetos listados no Context7 são desenvolvidos e mantidos por seus respectivos proprietários, não pelo Context7. Se você encontrar qualquer conteúdo suspeito, impróprio ou potencialmente prejudicial, use o botão "Report" na página do projeto para nos notificar imediatamente. Levamos todos os relatos a sério e revisaremos o conteúdo sinalizado prontamente para manter a integridade e a segurança de nossa plataforma. Ao usar o Context7, você reconhece que o faz por sua própria conta e risco.+## 🤝 Conecte-se ConoscoMantenha-se atualizado e junte-se à nossa comunidade:- 📢 Siga-nos no [X](https://x.com/context7ai) para as últimas notícias e atualizações- 🌐 Visite nosso [Website](https://context7.com)- 💬 Junte-se ao nosso [Discord Community](https://upstash.com/discord)+## 📺 Context7 na Mídia- [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)@@ -888,7 +1024,9 @@ Mantenha-se atualizado e junte-se à nossa comunidade:- [Income Stream Surfers: "Context7: The New MCP Server That Will CHANGE AI Coding"](https://www.youtube.com/watch?v=PS-2Azb-C3M)- [AICodeKing: "Context7 + Cline & RooCode: This MCP Server Makes CLINE 100X MORE EFFECTIVE!"](https://www.youtube.com/watch?v=qZfENAPMnyo)- [Sean Kochel: "5 MCP Servers For Vibe Coding Glory (Just Plug-In & Go)"](https://www.youtube.com/watch?v=LqTQi8qexJM)+## ⭐ Histórico de Stars[](https://www.star-history.com/#upstash/context7&Date)+## 📄 LicençaMITdiff --git a/i18n/README.ru.md b/i18n/README.ru.mdindex b136e324..faf5ec10 100644--- a/i18n/README.ru.md+++ b/i18n/README.ru.md@@ -63,6 +63,7 @@ npx -y @smithery/cli install @upstash/context7-mcp --client claude<details><summary>Альтернативный вариант - Bun</summary>+```json{"mcpServers": {@@ -74,8 +75,10 @@ npx -y @smithery/cli install @upstash/context7-mcp --client claude}```</details>+<details><summary>Альтернативный вариант - Deno</summary>+```json{"mcpServers": {@@ -87,6 +90,7 @@ npx -y @smithery/cli install @upstash/context7-mcp --client claude}```</details>+### Установка в WindsurfДобавьте следующие строки в ваш конфигурационный файл Windsurf MCP. Смотрите [документацию Windsurf MCP](https://docs.windsurf.com/windsurf/mcp) для получения дополнительной информации.```json@@ -99,6 +103,7 @@ npx -y @smithery/cli install @upstash/context7-mcp --client claude}}```+### Установка в VS Code[<img alt="Установка в VS Code (npx)" src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Установить%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="Установка в VS Code Insiders (npx)" src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Установить%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)@@ -114,6 +119,7 @@ npx -y @smithery/cli install @upstash/context7-mcp --client claude}}```+### Установка in ZedМожно установить через [Zed расширение](https://zed.dev/extensions?query=Context7) или добавить следующие строки в `settings.json`. Смотрите [документацию Zed Context Server](https://zed.dev/docs/assistant/context-servers) для получения дополнительной информации.```json@@ -127,11 +133,13 @@ npx -y @smithery/cli install @upstash/context7-mcp --client claude}}```+### Установка в Claude CodeЗапустите следующую команду для установки. Смотрите [документацию Claude Code MCP](https://docs.anthropic.com/ru/docs/claude-code/mcp) для получения дополнительной информации.```shclaude mcp add context7 -- npx -y @upstash/context7-mcp```+### Установка в Claude DesktopДобавьте следующие следующие строки в ваш конфигурационный файл `claude_desktop_config.json`. Смотрите [документацию Claude Desktop MCP](https://modelcontextprotocol.io/quickstart/user) для получения дополнительной информации.```json@@ -144,6 +152,7 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp}}```+### Установка в BoltAIОткройте страницу "Settings", перейдите в "Plugins" и добавьте следующие JSON-строки:```json@@ -156,6 +165,7 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp}}```+### Установка в Copilot Coding AgentДобавьте следующую конфигурацию в секцию `mcp` вашего файла настроек Copilot Coding Agent (Repository->Settings->Copilot->Coding agent->MCP configuration):```json@@ -170,6 +180,7 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp}```Подробнее см. в [официальной документации GitHub](https://docs.github.com/en/enterprise-cloud@latest/copilot/how-tos/agents/copilot-coding-agent/extending-copilot-coding-agent-with-mcp).+### Установка в Copilot CLI1. Откройте файл конфигурации MCP Copilot CLI. Расположение: `~/.copilot/mcp-config.json` (где `~` — ваша домашняя папка).2. Добавьте следующее к объекту `mcpServers` в вашем файле `mcp-config.json`:@@ -201,12 +212,14 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp}```Если файл `mcp-config.json` не существует, создайте его.+### Используя DockerЕсли вы предпочитаете запускать MCP сервер в Docker контейнере:1. **Создайте образ Docker:**Во-первых, создайте `Dockerfile` в корне вашего проекта (или в любом другом месте):<details><summary>Нажмите, чтобы просмотреть содержимое файла Dockerfile</summary>+```DockerfileFROM node:18-alpineWORKDIR /app@@ -218,6 +231,7 @@ claude mcp add context7 -- npx -y @upstash/context7-mcpCMD ["context7-mcp"]```</details>+Затем, соберите образ, используя тег (например, `context7-mcp`). **Убедитесь, что Docker Desktop (или демон Docker) работает.** Запустите следующую команду в этой же директории, где сохранён `Dockerfile`:```bashdocker build -t context7-mcp .@@ -240,6 +254,7 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp}```_Примечение: это пример конфигурации. Обратитесь к конкретным примерам для вашего MCP-клиента (например, Cursor, VS Code и т.д.), в предыдущих разделах этого README, чтобы адаптировать структуру (например, `mcpServers` вместо `servers`). Также убедитесь, что имя образа в `args` соответствует тегу, использованному при выполнении команды `docker build`._+### Установка в WindowsКонфигурация в Windows немного отличается от Linux или macOS (_в качестве примера используется `Cline`_). Однако, эти же же принципы применимы и к другим редакторам. В случае необходимости обратитесь к настройкам `command` и `args`.```json@@ -254,6 +269,7 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp}}```+### Доступные инструменты- `resolve-library-id`: преобразует общее название библиотеки в совместимый с Context7 идентификатор.- `query` (обязательно): вопрос или задача пользователя (для ранжирования по релевантности)@@ -261,6 +277,7 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp- `query-docs`: получает документацию по библиотеке по совместимому с Context7 идентификатору.- `libraryId` (обязательно): точный совместимый с Context7 идентификатор (например, `/mongodb/docs`, `/vercel/next.js`)- `query` (обязательно): вопрос или задача для получения релевантной документации+## РазработкаСклонируйте проект и установите зависимости:```bash@@ -270,6 +287,7 @@ pnpm i```bashpnpm run build```+### Пример локальной конфигурации```json{@@ -281,11 +299,14 @@ pnpm run build}}```+### Тестирование с помощью инспектора MCP```bashnpx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp```+## Решение проблем+### ERR_MODULE_NOT_FOUNDЕсли вы видите эту ошибку, используйте `bunx` вместо `npx`.```json@@ -299,6 +320,7 @@ npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp}```Зачастую это решает проблему с недостающими модулями, особенно в окружении, где `npx` некорректно устанавливает или разрешает библиотеки.+### Проблемы с разрешением ESMЕсли вы сталкиваетесь с проблемой по типу: `Error: Cannot find module 'uriTemplate.js'`, попробуйте запустить команду с флагом `--experimental-vm-modules`:```json@@ -311,6 +333,7 @@ npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp}}```+### Проблемы с TLS/сертификатамиИспользуйте флаг `--experimental-fetch` c `npx`, чтобы избежать ошибки, связанные с TLS:```json@@ -323,20 +346,24 @@ npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp}}```+### Ошибки MCP клиента1. Попробуйте добавить тег `@latest` в имя пакета.2. Попробуйте использовать `bunx` как альтернативу `npx`.3. Попробуйте использовать `deno` как замену `npx` или `bunx`.4. Убедитесь, что используете версию Node v18 или выше, чтобы `npx` поддерживал встроенный `fetch`.+## Отказ от ответственностиПроекты Context7 создаются сообществом. Мы стремимся поддерживать высокое качество, однако не можем гарантировать точность, полноту или безопасность всей документации по библиотекам. Проекты, представленные в Context7, разрабатываются и поддерживаются их авторами, а не командой Context7.Если вы столкнётесь с подозрительным, неуместным или потенциально вредоносным контентом, пожалуйста, воспользуйтесь кнопкой "Report" на странице проекта, чтобы немедленно сообщить нам. Мы внимательно относимся ко всем обращениям и оперативно проверяем помеченные материалы, чтобы обеспечить надёжность и безопасность платформы.Используя Context7, вы признаёте, что делаете это по собственному усмотрению и на свой страх и риск.+## Оставайтесь с нами на связиБудьте в курсе последних новостей на наших платформах:- 📢 Следите за нашими новостями на [X](https://x.com/contextai), чтобы быть в курсе последних новостей- 🌐 Загляните на наш [сайт](https://context7.com)- 💬 При желании присоединяйтесь к нашему [сообществу в Discord](https://upstash.com/discord)+## Context7 в СМИ- [Better Stack: "Бесплатный инструмент делает Cursor в 10 раз умнее"](https://youtu.be/52FC3qObp9E)- [Cole Medin: "Это, без сомнения, ЛУЧШИЙ MCP-сервер для AI-помощников в коде"](https://www.youtube.com/watch?v=G7gK8H6u7Rs)@@ -346,7 +373,9 @@ npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp- [Income stream surfers: "Context7: новый MCP-сервер, который изменит кодинг с ИИ"](https://www.youtube.com/watch?v=PS-2Azb-C3M)- [AICodeKing: "Context7 + Cline & RooCode: Этот MCP сервер делает CLINE в 100 раз ЭФФЕКТИВНЕЕ!"](https://www.youtube.com/watch?v=qZfENAPMnyo)- [Sean Kochel: "5 MCP серверов для стремительного вайб-программирования (Подключи и Работай)"](https://www.youtube.com/watch?v=LqTQi8qexJM)+## История звёзд на GitHub[](https://www.star-history.com/#upstash/context7&Date)+## ЛицензияMITdiff --git a/i18n/README.tr.md b/i18n/README.tr.mdindex a0e5dbdf..933e5f83 100644--- a/i18n/README.tr.md+++ b/i18n/README.tr.md@@ -64,6 +64,7 @@ Aşağıdaki yapılandırmayı Cursor `~/.cursor/mcp.json` dosyanıza yapıştı<details><summary>Alternatif: Bun Kullanın</summary>+```json{"mcpServers": {@@ -75,8 +76,10 @@ Aşağıdaki yapılandırmayı Cursor `~/.cursor/mcp.json` dosyanıza yapıştı}```</details>+<details><summary>Alternatif: Deno Kullanın</summary>+```json{"mcpServers": {@@ -88,6 +91,7 @@ Aşağıdaki yapılandırmayı Cursor `~/.cursor/mcp.json` dosyanıza yapıştı}```</details>+### Windsurf'te KurulumBunu Windsurf MCP yapılandırma dosyanıza ekleyin. Daha fazla bilgi için [Windsurf MCP belgelerine](https://docs.windsurf.com/windsurf/mcp) bakabilirsiniz.```json@@ -100,6 +104,7 @@ Bunu Windsurf MCP yapılandırma dosyanıza ekleyin. Daha fazla bilgi için [Win}}```+### VS Code'da Kurulum[<img alt="VS Code'da Yükle (npx)" src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Context7%20MCP%20Y%C3%BCkle&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="VS Code Insiders'da Yükle (npx)" src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Context7%20MCP%20Y%C3%BCkle&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)@@ -115,6 +120,7 @@ Bunu VS Code MCP yapılandırma dosyanıza ekleyin. Daha fazla bilgi için [VS C}}```+### Zed'de Kurulum[Zed Uzantıları](https://zed.dev/extensions?query=Context7) aracılığıyla kurulabilir veya Zed `settings.json` dosyanıza ekleyebilirsiniz. Daha fazla bilgi için [Zed Context Server belgelerine](https://zed.dev/docs/assistant/context-servers) bakabilirsiniz.```json@@ -128,11 +134,13 @@ Bunu VS Code MCP yapılandırma dosyanıza ekleyin. Daha fazla bilgi için [VS C}}```+### Claude Code'da KurulumBu komutu çalıştırın. Daha fazla bilgi için [Claude Code MCP belgelerine](https://docs.anthropic.com/en/docs/claude-code/mcp) bakabilirsiniz.```shclaude mcp add context7 -- npx -y @upstash/context7-mcp@latest```+### Claude Desktop'ta KurulumBunu Claude Desktop `claude_desktop_config.json` dosyanıza ekleyin. Daha fazla bilgi için [Claude Desktop MCP belgelerine](https://modelcontextprotocol.io/quickstart/user) bakabilirsiniz.```json@@ -145,6 +153,7 @@ Bunu Claude Desktop `claude_desktop_config.json` dosyanıza ekleyin. Daha fazla}}```+### Copilot Coding Agent KurulumuAşağıdaki yapılandırmayı Copilot Coding Agent'ın `mcp` bölümüne ekleyin (Repository->Settings->Copilot->Coding agent->MCP configuration):```json@@ -159,12 +168,14 @@ Aşağıdaki yapılandırmayı Copilot Coding Agent'ın `mcp` bölümüne ekleyi}```Daha fazla bilgi için [resmi GitHub dokümantasyonuna](https://docs.github.com/en/enterprise-cloud@latest/copilot/how-tos/agents/copilot-coding-agent/extending-copilot-coding-agent-with-mcp) bakabilirsiniz.+### Docker KullanımıMCP sunucusunu bir Docker konteynerinde çalıştırmayı tercih ederseniz:1. **Docker Görüntüsü Oluşturun:**Önce, proje kökünde (veya tercih ettiğiniz herhangi bir yerde) bir `Dockerfile` oluşturun:<details><summary>Dockerfile içeriğini görmek için tıklayın</summary>+```DockerfileFROM node:18-alpineWORKDIR /app@@ -176,6 +187,7 @@ MCP sunucusunu bir Docker konteynerinde çalıştırmayı tercih ederseniz:CMD ["context7-mcp"]```</details>+Ardından, bir etiket (örneğin, `context7-mcp`) kullanarak görüntüyü oluşturun. **Docker Desktop'un (veya Docker daemon'un) çalıştığından emin olun.** `Dockerfile`'ı kaydettiğiniz dizinde aşağıdaki komutu çalıştırın:```bashdocker build -t context7-mcp .@@ -198,6 +210,7 @@ MCP sunucusunu bir Docker konteynerinde çalıştırmayı tercih ederseniz:}```_Not: Bu bir örnek yapılandırmadır. Yapıyı uyarlamak için MCP istemcinize (Cursor, VS Code vb.) özel örneklere bakın (örneğin, `mcpServers` ve `servers` farkı). Ayrıca, `args` içindeki görüntü adının `docker build` komutu sırasında kullanılan etiketle eşleştiğinden emin olun._+### Kullanılabilir Araçlar- `resolve-library-id`: Genel bir kütüphane adını Context7 uyumlu bir kütüphane ID'sine dönüştürür.- `query` (gerekli): Kullanıcının sorusu veya görevi (alaka sıralaması için)@@ -205,6 +218,7 @@ MCP sunucusunu bir Docker konteynerinde çalıştırmayı tercih ederseniz:- `query-docs`: Context7 uyumlu bir kütüphane ID'si kullanarak bir kütüphane için belgeleri getirir.- `libraryId` (gerekli): Context7 uyumlu tam kütüphane ID'si (örneğin, `/mongodb/docs`, `/vercel/next.js`)- `query` (gerekli): İlgili belgeleri almak için soru veya görev+## GeliştirmeProjeyi klonlayın ve bağımlılıkları yükleyin:```bash@@ -214,6 +228,7 @@ Derleyin:```bashpnpm run build```+### Yerel Yapılandırma Örneği```json{@@ -225,11 +240,14 @@ pnpm run build}}```+### MCP Inspector ile Test Etme```bashnpx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp@latest```+## Sorun Giderme+### ERR_MODULE_NOT_FOUNDBu hatayı görürseniz, `npx` yerine `bunx` kullanmayı deneyin.```json@@ -243,6 +261,7 @@ Bu hatayı görürseniz, `npx` yerine `bunx` kullanmayı deneyin.}```Bu, özellikle `npx`'in paketleri düzgün şekilde yüklemediği veya çözemediği ortamlarda modül çözümleme sorunlarını genellikle çözer.+### ESM Çözümleme Sorunları`Error: Cannot find module 'uriTemplate.js'` gibi bir hatayla karşılaşırsanız, `--experimental-vm-modules` bayrağıyla çalıştırmayı deneyin:```json@@ -255,13 +274,16 @@ Bu, özellikle `npx`'in paketleri düzgün şekilde yüklemediği veya çözemed}}```+### MCP İstemci Hataları1. Paket adından `@latest` ifadesini kaldırmayı deneyin.2. Alternatif olarak `bunx` kullanmayı deneyin.3. Alternatif olarak `deno` kullanmayı deneyin.4. `npx` ile yerel fetch desteğine sahip olmak için Node v18 veya daha yüksek bir sürüm kullandığınızdan emin olun.+## Sorumluluk ReddiContext7 projeleri topluluk katkılıdır ve yüksek kaliteyi korumaya çalışsak da, tüm kütüphane belgelerinin doğruluğunu, eksiksizliğini veya güvenliğini garanti edemeyiz. Context7'de listelenen projeler, Context7 tarafından değil, ilgili sahipleri tarafından geliştirilmekte ve sürdürülmektedir. Şüpheli, uygunsuz veya potansiyel olarak zararlı içerikle karşılaşırsanız, lütfen bizi hemen bilgilendirmek için proje sayfasındaki "Bildir" düğmesini kullanın. Tüm bildirimleri ciddiye alıyoruz ve platformumuzun bütünlüğünü ve güvenliğini korumak için işaretlenen içeriği hızla inceleyeceğiz. Context7'yi kullanarak, bunu kendi takdirinizle ve riskinizle yaptığınızı kabul etmiş olursunuz.+## Context7 Medyada- [Better Stack: "Ücretsiz Araç Cursor'u 10 Kat Daha Akıllı Yapıyor"](https://youtu.be/52FC3qObp9E)- [Cole Medin: "Bu, Tartışmasız AI Kodlama Asistanları İçin EN İYİ MCP Sunucusudur"](https://www.youtube.com/watch?v=G7gK8H6u7Rs)@@ -271,7 +293,9 @@ Context7 projeleri topluluk katkılıdır ve yüksek kaliteyi korumaya çalışs- [Income stream surfers: "Context7: AI Kodlamayı DEĞİŞTİRECEK Yeni MCP Sunucusu"](https://www.youtube.com/watch?v=PS-2Azb-C3M)- [AICodeKing: "Context7 + Cline & RooCode: Bu MCP Sunucusu CLINE'ı 100 KAT DAHA ETKİLİ YAPIYOR!"](https://www.youtube.com/watch?v=qZfENAPMnyo)- [Sean Kochel: "Vibe Kodlama İhtişamı İçin 5 MCP Sunucusu (Tak ve Çalıştır)"](https://www.youtube.com/watch?v=LqTQi8qexJM)+## Yıldız Geçmişi[](https://www.star-history.com/#upstash/context7&Date)+## LisansMITdiff --git a/i18n/README.uk.md b/i18n/README.uk.mdindex 6cfb8c84..cb7a566c 100644--- a/i18n/README.uk.md+++ b/i18n/README.uk.md@@ -43,6 +43,7 @@ Context7 завантажує свіжі приклади коду й докум- Cursor, Windsurf, Claude Desktop або інший MCP-клієнт<details><summary><b>Встановлення через Smithery</b></summary>+Для автоматичного встановлення Context7 MCP Server для будь-якого клієнта через [Smithery](https://smithery.ai/server/@upstash/context7-mcp):```bash@@ -52,11 +53,14 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>Ваш ключ Smithery можна знайти на [сторінці Smithery.ai](https://smithery.ai/server/@upstash/context7-mcp).</details>+<details><summary><b>Встановлення в Cursor</b></summary>+Перейдіть до: `Settings` → `Cursor Settings` → `MCP` → `Add new global MCP server`Рекомендується вставити наступну конфігурацію у файл `~/.cursor/mcp.json`. Також можна встановити для конкретного проєкту, створивши `.cursor/mcp.json` у теці проєкту. Детальніше див. у [документації Cursor MCP](https://docs.cursor.com/context/model-context-protocol).> Починаючи з Cursor 1.0, ви можете просто натиснути кнопку встановлення нижче для миттєвої інсталяції.+#### Підключення до віддаленого сервера Cursor[](https://cursor.com/install-mcp?name=context7&config=eyJ1cmwiOiJodHRwczovL21jcC5jb250ZXh0Ny5jb20vbWNwIn0%3D)```json@@ -68,6 +72,7 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}}```+#### Підключення до локального сервера Cursor[](https://cursor.com/install-mcp?name=context7&config=eyJjb21tYW5kIjoibnB4IC15IEB1cHN0YXNoL2NvbnRleHQ3LW1jcCJ9)```json@@ -82,6 +87,7 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>```<details><summary>Альтернатива: використання Bun</summary>+[](https://cursor.com/install-mcp?name=context7&config=eyJjb21tYW5kIjoiYnVueCAteSBAdXBzdGFzaC9jb250ZXh0Ny1tY3AifQ%3D%3D)```json{@@ -94,8 +100,10 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}```</details>+<details><summary>Альтернатива: використання Deno</summary>+[](https://cursor.com/install-mcp?name=context7&config=eyJjb21tYW5kIjoiZGVubyBydW4gLS1hbGxvdy1lbnYgLS1hbGxvdy1uZXQgbnBtOkB1cHN0YXNoL2NvbnRleHQ3LW1jcCJ9)```json{@@ -113,11 +121,16 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}```</details>+</details>+<details><summary><b>Встановлення в Windsurf</b></summary>+Додайте це до вашого конфігураційного файлу Windsurf MCP. Детальніше див. у [документації Windsurf MCP](https://docs.windsurf.com/windsurf/mcp).+#### Підключення до віддаленого сервера Windsurf+```json{"mcpServers": {@@ -127,7 +140,9 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}}```+#### Підключення до локального сервера Windsurf+```json{"mcpServers": {@@ -139,11 +154,15 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}```</details>+<details><summary><b>Встановлення в Trae</b></summary>+Використовуйте функцію "Add manually" і заповніть конфігурацію JSON для цього MCP-сервера.Детальніше див. у [документації Trae](https://docs.trae.ai/ide/model-context-protocol?_lang=en).+#### Підключення до віддаленого сервера Trae+```json{"mcpServers": {@@ -153,7 +172,9 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}}```+#### Підключення до локального сервера Trae+```json{"mcpServers": {@@ -165,12 +186,16 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}```</details>+<details><summary><b>Встановлення в VS Code</b></summary>+[<img alt="Встановити в VS Code (npx)" src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Встановити%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="Встановити в VS Code Insiders (npx)" src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Встановити%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)Додайте це до вашого конфігураційного файлу VS Code MCP. Детальніше див. у [документації VS Code MCP](https://code.visualstudio.com/docs/copilot/chat/mcp-servers).+#### Підключення до віддаленого сервера VS Code+```json"mcp": {"servers": {@@ -181,7 +206,9 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}}```+#### Підключення до локального сервера VS Code+```json"mcp": {"servers": {@@ -194,8 +221,10 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}```</details>+<details><summary><b>Встановлення в Visual Studio 2022</b></summary>+Ви можете налаштувати Context7 MCP у Visual Studio 2022, дотримуючись [документації Visual Studio MCP Servers](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022).Додайте це до вашого конфігураційного файлу Visual Studio MCP (детальніше в [документації Visual Studio](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022)):```json@@ -225,8 +254,10 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}```</details>+<details><summary><b>Встановлення в Zed</b></summary>+Можна встановити через [розширення Zed](https://zed.dev/extensions?query=Context7) або додати це до вашого `settings.json`. Детальніше див. у [документації Zed Context Server](https://zed.dev/docs/assistant/context-servers).```json{@@ -240,8 +271,10 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}```</details>+<details><summary><b>Встановлення в Copilot Coding Agent</b></summary>+## Використання Context7 з Copilot Coding AgentДодайте наступну конфігурацію до розділу `mcp` вашого файла настроек Copilot Coding Agent Repository->Settings->Copilot->Coding agent->MCP configuration:```json@@ -260,8 +293,10 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>```Детальніше див. в [офіційній документації GitHub](https://docs.github.com/en/enterprise-cloud@latest/copilot/how-tos/agents/copilot-coding-agent/extending-copilot-coding-agent-with-mcp).</details>+<details><summary><b>Встановлення в Copilot CLI</b></summary>+1. Відкрийте файл конфігурації MCP Copilot CLI. Розташування: `~/.copilot/mcp-config.json` (де `~` — ваша домашня папка).2. Додайте наступне до об'єкта `mcpServers` у вашому файлі `mcp-config.json`:```json@@ -293,8 +328,10 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>```Якщо файл `mcp-config.json` не існує, створіть його.</details>+<details><summary><b>Встановлення в Gemini CLI</b></summary>+Детальніше див. у [конфігурації Gemini CLI](https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/configuration.md).1. Відкрийте файл налаштувань Gemini CLI. Розташування: `~/.gemini/settings.json` (де `~` — ваша домашня тека).2. Додайте наступне до об'єкта `mcpServers` у вашому `settings.json`:@@ -310,20 +347,28 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>```Якщо об'єкт `mcpServers` не існує, створіть його.</details>+<details><summary><b>Встановлення в Claude Code</b></summary>+Виконайте цю команду. Детальніше див. у [документації Claude Code MCP](https://docs.anthropic.com/en/docs/claude-code/mcp).+#### Підключення до локального сервера Claude Code+```shclaude mcp add context7 -- npx -y @upstash/context7-mcp```+#### Підключення до віддаленого сервера Claude Code+```shclaude mcp add --transport http context7 https://mcp.context7.com/mcp```</details>+<details><summary><b>Встановлення в Claude Desktop</b></summary>+Додайте це до вашого файлу `claude_desktop_config.json` у Claude Desktop. Детальніше див. у [документації Claude Desktop MCP](https://modelcontextprotocol.io/quickstart/user).```json{@@ -336,16 +381,20 @@ claude mcp add --transport http context7 https://mcp.context7.com/mcp}```</details>+<details><summary><b>Встановлення в Cline</b></summary>+Ви можете легко встановити Context7 через [торговий майданчик MCP-серверів Cline](https://cline.bot/mcp-marketplace), дотримуючись цих інструкцій:1. Відкрийте **Cline**.2. Натисніть значок меню гамбургер (☰), щоб увійти до розділу **MCP Servers**.3. Використовуйте панель пошуку у вкладці **Marketplace**, щоб знайти _Context7_.4. Натисніть кнопку **Install**.</details>+<details><summary><b>Встановлення в BoltAI</b></summary>+Відкрийте сторінку "Settings" застосунку, перейдіть до "Plugins" і введіть наступний JSON:```json{@@ -359,13 +408,16 @@ claude mcp add --transport http context7 https://mcp.context7.com/mcp```Після збереження введіть у чаті `query-docs`, а потім ваш ідентифікатор документації Context7 (наприклад, `query-docs /nuxt/ui`). Додаткова інформація доступна на [сайті документації BoltAI](https://docs.boltai.com/docs/plugins/mcp-servers). Для BoltAI на iOS [див. цей посібник](https://docs.boltai.com/docs/boltai-mobile/mcp-servers).</details>+<details><summary><b>Використання Docker</b></summary>+Якщо ви віддаєте перевагу запуску MCP-сервера в Docker-контейнері:1. **Створіть Docker-образ:**Спочатку створіть `Dockerfile` у корені проєкту (або де завгодно):<details><summary>Натисніть, щоб побачити вміст Dockerfile</summary>+```DockerfileFROM node:18-alpineWORKDIR /app@@ -377,6 +429,7 @@ claude mcp add --transport http context7 https://mcp.context7.com/mcpCMD ["context7-mcp"]```</details>+Потім створіть образ, використовуючи тег (наприклад, `context7-mcp`). **Переконайтеся, що Docker Desktop (або демон Docker) запущений.** Виконайте наступну команду в тій же теці, де ви зберегли `Dockerfile`:```bashdocker build -t context7-mcp .@@ -400,8 +453,10 @@ claude mcp add --transport http context7 https://mcp.context7.com/mcp```_Примітка: Це приклад конфігурації. Будь ласка, зверніться до конкретних прикладів для вашого MCP-клієнта (наприклад, Cursor, VS Code тощо) раніше в цьому README, щоб адаптувати структуру (наприклад, `mcpServers` проти `servers`). Також переконайтеся, що назва образу в `args` збігається з тегом, використаним під час команди `docker build`._</details>+<details><summary><b>Встановлення в Windows</b></summary>+Конфігурація в Windows дещо відрізняється від Linux або macOS (_у прикладі використовується `Cline`_). Той же принцип застосовується до інших редакторів; зверніться до конфігурації `command` та `args`.```json{@@ -416,9 +471,12 @@ claude mcp add --transport http context7 https://mcp.context7.com/mcp}```</details>+<details><summary><b>Встановлення в Augment Code</b></summary>+Для налаштування Context7 MCP в Augment Code ви можете використовувати або графічний інтерфейс, або ручну конфігурацію.+### **A. Використання інтерфейсу Augment Code**1. Натисніть меню гамбургер.2. Виберіть **Settings**.@@ -430,6 +488,7 @@ claude mcp add --transport http context7 https://mcp.context7.com/mcp```6. Назва MCP: **Context7**.7. Натисніть кнопку **Add**.+### **B. Ручна конфігурація**1. Натисніть Cmd/Ctrl Shift P або перейдіть до меню гамбургер у панелі Augment2. Виберіть Edit Settings@@ -447,10 +506,14 @@ claude mcp add --transport http context7 https://mcp.context7.com/mcp}```</details>+<details><summary><b>Встановлення в Roo Code</b></summary>+Додайте це до вашого конфігураційного файлу Roo Code MCP. Детальніше див. у [документації Roo Code MCP](https://docs.roocode.com/features/mcp/using-mcp-in-roo).+#### Підключення до віддаленого сервера Roo Code+```json{"mcpServers": {@@ -461,7 +524,9 @@ claude mcp add --transport http context7 https://mcp.context7.com/mcp}}```+#### Підключення до локального сервера Roo Code+```json{"mcpServers": {@@ -473,8 +538,10 @@ claude mcp add --transport http context7 https://mcp.context7.com/mcp}```</details>+<details><summary><b>Встановлення в Zencoder</b></summary>+Для налаштування Context7 MCP в Zencoder виконайте наступні кроки:1. Перейдіть до меню Zencoder (...)2. З випадного меню виберіть Agent tools@@ -487,8 +554,10 @@ claude mcp add --transport http context7 https://mcp.context7.com/mcp}```</details>+<details><summary><b>Встановлення в Amazon Q Developer CLI</b></summary>+Додайте це до вашого конфігураційного файлу Amazon Q Developer CLI. Детальніше див. у [документації Amazon Q Developer CLI](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-configuration.html).```json{@@ -501,8 +570,10 @@ claude mcp add --transport http context7 https://mcp.context7.com/mcp}```</details>+<details><summary><b>Встановлення в Qodo Gen</b></summary>+Детальніше див. у [документації Qodo Gen](https://docs.qodo.ai/qodo-documentation/qodo-gen/qodo-gen-chat/agentic-mode/agentic-tools-mcps).1. Відкрийте панель чату Qodo Gen у VSCode або IntelliJ.2. Натисніть Connect more tools.@@ -518,8 +589,10 @@ claude mcp add --transport http context7 https://mcp.context7.com/mcp}```</details>+<details><summary><b>Встановлення в JetBrains AI Assistant</b></summary>+Детальніше див. у [документації JetBrains AI Assistant](https://www.jetbrains.com/help/ai-assistant/configure-an-mcp-server.html).1. У JetBrains IDE перейдіть до `Settings` → `Tools` → `AI Assistant` → `Model Context Protocol (MCP)`2. Натисніть `+ Add`.@@ -537,8 +610,10 @@ claude mcp add --transport http context7 https://mcp.context7.com/mcp```5. Натисніть `Apply`, щоб зберегти зміни.</details>+<details><summary><b>Встановлення в Warp</b></summary>+Детальніше див. у [документації Warp Model Context Protocol](https://docs.warp.dev/knowledge-and-collaboration/mcp#adding-an-mcp-server).1. Перейдіть до `Settings` > `AI` > `Manage MCP servers`.2. Додайте новий MCP-сервер, натиснувши кнопку `+ Add`.@@ -556,10 +631,14 @@ claude mcp add --transport http context7 https://mcp.context7.com/mcp```4. Натисніть `Save`, щоб застосувати зміни.</details>+<details><summary><b>Встановлення в Opencode</b></summary>+Додайте це до вашого конфігураційного файлу Opencode. Детальніше див. у [документації Opencode MCP](https://opencode.ai/docs/mcp-servers).+#### Підключення до віддаленого сервера Opencode+```json"mcp": {"context7": {@@ -569,7 +648,9 @@ claude mcp add --transport http context7 https://mcp.context7.com/mcp}}```+#### Підключення до локального сервера Opencode+```json{"mcp": {@@ -582,6 +663,7 @@ claude mcp add --transport http context7 https://mcp.context7.com/mcp}```</details>+## 🔨 Доступні інструментиContext7 MCP надає наступні інструменти, які можуть використовувати великі мовні моделі:- `resolve-library-id`: Перетворює загальну назву бібліотеки на сумісний з Context7 ідентифікатор бібліотеки.@@ -590,7 +672,9 @@ Context7 MCP надає наступні інструменти, які можу- `query-docs`: Отримує документацію для бібліотеки, використовуючи сумісний з Context7 ідентифікатор бібліотеки.- `libraryId` (обов'язково): Точний сумісний з Context7 ідентифікатор бібліотеки (наприклад, `/mongodb/docs`, `/vercel/next.js`)- `query` (обов'язково): Питання або завдання для отримання релевантної документації+## 🛟 Поради+### Додайте правило> Якщо ви не хочете додавати `use context7` до кожного промпту, ви можете визначити просте правило у вашому файлі `.windsurfrules` в Windsurf або в розділі `Cursor Settings > Rules` в Cursor (або еквівалентному у вашому MCP-клієнті), щоб автоматично викликати Context7 для будь-яких запитань про код:>@@ -601,6 +685,7 @@ Context7 MCP надає наступні інструменти, які можу> ```>> Відтоді ви отримуватимете документацію Context7 у будь-якій пов'язаній розмові без введення будь-чого додаткового. Ви можете додати свої випадки використання до частини match.+### Використовуйте ідентифікатор бібліотеки> Якщо ви вже точно знаєте, яку бібліотеку хочете використовувати, додайте її ідентифікатор Context7 до вашого промпту. Таким чином Context7 MCP-сервер може пропустити крок пошуку бібліотеки та одразу перейти до отримання документації.>@@ -609,6 +694,7 @@ Context7 MCP надає наступні інструменти, які можу> ```>> Синтаксис із слешем повідомляє MCP-інструменту точно, для якої бібліотеки завантажувати документацію.+## 💻 РозробкаСклонуйте проєкт і встановіть залежності:```bash@@ -622,6 +708,7 @@ pnpm run build```bashnode packages/mcp/dist/index.js```+### Аргументи командного рядка`context7-mcp` приймає наступні прапори CLI:- `--transport <stdio|http>` — Транспорт для використання (`stdio` за замовчуванням).@@ -632,6 +719,7 @@ node packages/mcp/dist/index.js --transport http --port 8080```<details><summary><b>Приклад локальної конфігурації</b></summary>+```json{"mcpServers": {@@ -643,15 +731,19 @@ node packages/mcp/dist/index.js --transport http --port 8080}```</details>+<details><summary><b>Тестування з MCP Inspector</b></summary>+```bashnpx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp```</details>+## 🚨 Усунення несправностей<details><summary><b>Помилки "Module Not Found"</b></summary>+Якщо ви стикаєтеся з `ERR_MODULE_NOT_FOUND`, спробуйте використовувати `bunx` замість `npx`:```json{@@ -665,8 +757,10 @@ npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp```Це часто вирішує проблеми розв'язання модулів у середовищах, де `npx` не встановлює або не розв'язує пакунки належним чином.</details>+<details><summary><b>Проблеми розв'язання ESM</b></summary>+Для помилок типу `Error: Cannot find module 'uriTemplate.js'` спробуйте прапор `--experimental-vm-modules`:```json{@@ -679,8 +773,10 @@ npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp}```</details>+<details><summary><b>Проблеми TLS/сертифікатів</b></summary>+Використовуйте прапор `--experimental-fetch`, щоб обійти проблеми, пов'язані з TLS:```json{@@ -693,20 +789,25 @@ npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp}```</details>+<details><summary><b>Загальні помилки MCP-клієнта</b></summary>+1. Спробуйте додати `@latest` до назви пакунка2. Використовуйте `bunx` як альтернативу до `npx`3. Розгляньте використання `deno` як іншу альтернативу4. Переконайтеся, що ви використовуєте Node.js v18 або вище для підтримки нативного fetch</details>+## ⚠️ ЗастереженняПроєкти Context7 створюються спільнотою, і хоча ми прагнемо підтримувати високу якість, ми не можемо гарантувати точність, повноту або безпеку всієї документації бібліотек. Проєкти, перелічені в Context7, розробляються та підтримуються їхніми відповідними власниками, а не Context7. Якщо ви зіткнетеся з будь-яким підозрілим, неприйнятним або потенційно шкідливим контентом, будь ласка, використовуйте кнопку "Report" на сторінці проєкту, щоб негайно повідомити нас. Ми серйозно ставимося до всіх звітів і оперативно переглядаємо позначений контент для підтримання цілісності та безпеки нашої платформи. Використовуючи Context7, ви визнаєте, що робите це на власний розсуд і ризик.+## 🤝 Зв'яжіться з намиЗалишайтеся в курсі подій та приєднуйтеся до нашої спільноти:- 📢 Слідкуйте за нами в [X](https://x.com/contextai) для отримання останніх новин та оновлень- 🌐 Відвідайте наш [веб-сайт](https://context7.com)- 💬 Приєднуйтеся до нашої [спільноти Discord](https://upstash.com/discord)+## 📺 Context7 у медіа- [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)@@ -716,7 +817,9 @@ npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp- [Income Stream Surfers: "Context7: The New MCP Server That Will CHANGE AI Coding"](https://www.youtube.com/watch?v=PS-2Azb-C3M)- [AICodeKing: "Context7 + Cline & RooCode: This MCP Server Makes CLINE 100X MORE EFFECTIVE!"](https://www.youtube.com/watch?v=qZfENAPMnyo)- [Sean Kochel: "5 MCP Servers For Vibe Coding Glory (Just Plug-In & Go)"](https://www.youtube.com/watch?v=LqTQi8qexJM)+## ⭐ Історія зірок[](https://www.star-history.com/#upstash/context7&Date)+## 📄 ЛіцензіяMITdiff --git a/i18n/README.vi.md b/i18n/README.vi.mdindex 254352d3..9ef1e5f2 100644--- a/i18n/README.vi.md+++ b/i18n/README.vi.md@@ -43,6 +43,7 @@ Xem [hướng dẫn thêm dự án](./adding-projects.md) để học cách thê- Cursor, Windsurf, Claude Desktop hoặc MCP Client khác<details><summary><b>Cài đặt qua Smithery</b></summary>+Để cài đặt Context7 MCP Server cho bất kỳ client nào tự động qua [Smithery](https://smithery.ai/server/@upstash/context7-mcp):```bash@@ -52,11 +53,14 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>Bạn có thể tìm Smithery key của mình tại [trang web Smithery.ai](https://smithery.ai/server/@upstash/context7-mcp).</details>+<details><summary><b>Cài đặt trong Cursor</b></summary>+Đi đến: `Settings` -> `Cursor Settings` -> `MCP` -> `Add new global MCP server`Paste cấu hình sau vào file Cursor `~/.cursor/mcp.json` là cách được khuyến nghị. Bạn cũng có thể cài đặt trong một dự án cụ thể bằng cách tạo `.cursor/mcp.json` trong thư mục dự án. Xem [tài liệu Cursor MCP](https://docs.cursor.com/context/model-context-protocol) để biết thêm thông tin.> Từ Cursor 1.0, bạn có thể click nút cài đặt bên dưới để cài đặt một cú click ngay lập tức.+#### Kết nối Cursor Remote Server[](https://cursor.com/install-mcp?name=context7&config=eyJ1cmwiOiJodHRwczovL21jcC5jb250ZXh0Ny5jb20vbWNwIn0%3D)```json@@ -68,6 +72,7 @@ Paste cấu hình sau vào file Cursor `~/.cursor/mcp.json` là cách được k}}```+#### Kết nối Cursor Local Server[](https://cursor.com/install-mcp?name=context7&config=eyJjb21tYW5kIjoibnB4IC15IEB1cHN0YXNoL2NvbnRleHQ3LW1jcCJ9)```json@@ -82,6 +87,7 @@ Paste cấu hình sau vào file Cursor `~/.cursor/mcp.json` là cách được k```<details><summary>Thay thế: Sử dụng Bun</summary>+[](https://cursor.com/install-mcp?name=context7&config=eyJjb21tYW5kIjoiYnVueCAteSBAdXBzdGFzaC9jb250ZXh0Ny1tY3AifQ%3D%3D)```json{@@ -94,8 +100,10 @@ Paste cấu hình sau vào file Cursor `~/.cursor/mcp.json` là cách được k}```</details>+<details><summary>Thay thế: Sử dụng Deno</summary>+[](https://cursor.com/install-mcp?name=context7&config=eyJjb21tYW5kIjoiZGVubyBydW4gLS1hbGxvdy1lbnYgLS1hbGxvdy1uZXQgbnBtOkB1cHN0YXNoL2NvbnRleHQ3LW1jcCJ9)```json{@@ -113,11 +121,16 @@ Paste cấu hình sau vào file Cursor `~/.cursor/mcp.json` là cách được k}```</details>+</details>+<details><summary><b>Cài đặt trong Windsurf</b></summary>+Thêm cấu hình này vào file cấu hình Windsurf MCP của bạn. Xem [tài liệu Windsurf MCP](https://docs.windsurf.com/windsurf/mcp) để biết thêm thông tin.+#### Kết nối Windsurf Remote Server+```json{"mcpServers": {@@ -127,7 +140,9 @@ Thêm cấu hình này vào file cấu hình Windsurf MCP của bạn. Xem [tài}}```+#### Kết nối Windsurf Local Server+```json{"mcpServers": {@@ -139,11 +154,15 @@ Thêm cấu hình này vào file cấu hình Windsurf MCP của bạn. Xem [tài}```</details>+<details><summary><b>Cài đặt trong Trae</b></summary>+Sử dụng tính năng Add manually và điền thông tin cấu hình JSON cho MCP server đó.Để biết thêm chi tiết, truy cập [tài liệu Trae](https://docs.trae.ai/ide/model-context-protocol?_lang=en).+#### Kết nối Trae Remote Server+```json{"mcpServers": {@@ -153,7 +172,9 @@ Sử dụng tính năng Add manually và điền thông tin cấu hình JSON cho}}```+#### Kết nối Trae Local Server+```json{"mcpServers": {@@ -165,12 +186,16 @@ Sử dụng tính năng Add manually và điền thông tin cấu hình JSON cho}```</details>+<details><summary><b>Cài đặt trong VS Code</b></summary>+[<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)[<img alt="Install in VS Code Insiders (npx)" src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Install%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)Thêm cấu hình này vào file cấu hình VS Code MCP của bạn. Xem [tài liệu VS Code MCP](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) để biết thêm thông tin.+#### Kết nối VS Code Remote Server+```json"mcp": {"servers": {@@ -181,7 +206,9 @@ Thêm cấu hình này vào file cấu hình VS Code MCP của bạn. Xem [tài}}```+#### Kết nối VS Code Local Server+```json"mcp": {"servers": {@@ -194,8 +221,10 @@ Thêm cấu hình này vào file cấu hình VS Code MCP của bạn. Xem [tài}```</details>+<details><summary><b>Cài đặt trong Visual Studio 2022</b></summary>+Bạn có thể cấu hình Context7 MCP trong Visual Studio 2022 bằng cách làm theo [tài liệu Visual Studio MCP Servers](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022).Thêm cấu hình này vào file cấu hình Visual Studio MCP của bạn (xem [tài liệu Visual Studio](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022) để biết chi tiết):```json@@ -226,8 +255,10 @@ Hoặc, cho local server:```Để biết thêm thông tin và khắc phục sự cố, tham khảo [tài liệu Visual Studio MCP Servers](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022).</details>+<details><summary><b>Cài đặt trong Zed</b></summary>+Có thể cài đặt thông qua [Zed Extensions](https://zed.dev/extensions?query=Context7) hoặc bạn có thể thêm cấu hình này vào `settings.json` của Zed. Xem [tài liệu Zed Context Server](https://zed.dev/docs/assistant/context-servers) để biết thêm thông tin.```json{@@ -241,8 +272,10 @@ Có thể cài đặt thông qua [Zed Extensions](https://zed.dev/extensions?que}```</details>+<details><summary><b>Cài đặt trong Gemini CLI</b></summary>+Xem [Cấu hình Gemini CLI](https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/configuration.md) để biết chi tiết.1. Mở file cài đặt Gemini CLI. Vị trí là `~/.gemini/settings.json` (trong đó `~` là thư mục home của bạn).2. Thêm cấu hình sau vào object `mcpServers` trong file `settings.json` của bạn:@@ -268,20 +301,28 @@ Hoặc, cho local server:```Nếu object `mcpServers` không tồn tại, hãy tạo nó.</details>+<details><summary><b>Cài đặt trong Claude Code</b></summary>+Chạy lệnh này. Xem [tài liệu Claude Code MCP](https://docs.anthropic.com/en/docs/claude-code/mcp) để biết thêm thông tin.+#### Kết nối Claude Code Local Server+```shclaude mcp add context7 -- npx -y @upstash/context7-mcp```+#### Kết nối Claude Code Remote Server+```shclaude mcp add --transport http context7 https://mcp.context7.com/mcp```</details>+<details><summary><b>Cài đặt trong Claude Desktop</b></summary>+Thêm cấu hình này vào file `claude_desktop_config.json` của Claude Desktop. Xem [tài liệu Claude Desktop MCP](https://modelcontextprotocol.io/quickstart/user) để biết thêm thông tin.```json{@@ -294,18 +335,22 @@ Thêm cấu hình này vào file `claude_desktop_config.json` của Claude Deskt}```</details>+<details><summary><b>Cài đặt trong Cline</b></summary>+Bạn có thể dễ dàng cài đặt Context7 thông qua [Cline MCP Server Marketplace](https://cline.bot/mcp-marketplace) bằng cách làm theo các hướng dẫn này:1. Mở **Cline**.2. Click biểu tượng menu hamburger (☰) để vào phần **MCP Servers**.3. Sử dụng thanh tìm kiếm trong tab **Marketplace** để tìm _Context7_.4. Click nút **Install**.</details>+<details><summary><b>Cài đặt trong BoltAI</b></summary>+Mở trang "Settings" của ứng dụng, điều hướng đến "Plugins," và nhập JSON sau:```json{@@ -319,13 +364,16 @@ Mở trang "Settings" của ứng dụng, điều hướng đến "Plugins," và```Sau khi lưu, nhập trong chat `query-docs` theo sau bởi Context7 documentation ID của bạn (ví dụ: `query-docs /nuxt/ui`). Thêm thông tin có sẵn tại [trang Tài liệu BoltAI](https://docs.boltai.com/docs/plugins/mcp-servers). Cho BoltAI trên iOS, [xem hướng dẫn này](https://docs.boltai.com/docs/boltai-mobile/mcp-servers).</details>+<details><summary><b>Sử dụng Docker</b></summary>+Nếu bạn muốn chạy MCP server trong Docker container:1. **Build Docker Image:**Đầu tiên, tạo `Dockerfile` trong thư mục gốc dự án (hoặc bất cứ đâu bạn thích):<details><summary>Click để xem nội dung Dockerfile</summary>+```DockerfileFROM node:18-alpineWORKDIR /app@@ -337,6 +385,7 @@ Nếu bạn muốn chạy MCP server trong Docker container:CMD ["context7-mcp"]```</details>+Sau đó, build image sử dụng tag (ví dụ: `context7-mcp`). **Đảm bảo Docker Desktop (hoặc Docker daemon) đang chạy.** Chạy lệnh sau trong cùng thư mục nơi bạn lưu `Dockerfile`:```bashdocker build -t context7-mcp .@@ -360,8 +409,10 @@ Nếu bạn muốn chạy MCP server trong Docker container:```_Lưu ý: Đây là một ví dụ cấu hình. Vui lòng tham khảo các ví dụ cụ thể cho MCP client của bạn (như Cursor, VS Code, v.v.) ở phần trước trong README này để điều chỉnh cấu trúc (ví dụ: `mcpServers` vs `servers`). Ngoài ra, đảm bảo tên image trong `args` khớp với tag được sử dụng trong lệnh `docker build`._</details>+<details><summary><b>Cài đặt trong Windows</b></summary>+Cấu hình trên Windows hơi khác so với Linux hoặc macOS (_`Cline` được sử dụng trong ví dụ_). Nguyên tắc tương tự áp dụng cho các editor khác; tham khảo cấu hình của `command` và `args`.```json{@@ -376,9 +427,12 @@ Cấu hình trên Windows hơi khác so với Linux hoặc macOS (_`Cline` đư}```</details>+<details><summary><b>Cài đặt trong Augment Code</b></summary>+Để cấu hình Context7 MCP trong Augment Code, bạn có thể sử dụng giao diện đồ họa hoặc cấu hình thủ công.+### **A. Sử dụng Augment Code UI**1. Click menu hamburger.2. Chọn **Settings**.@@ -392,6 +446,7 @@ Cấu hình trên Windows hơi khác so với Linux hoặc macOS (_`Cline` đư7. Click nút **Add**.Sau khi MCP server được thêm, bạn có thể bắt đầu sử dụng các tính năng tài liệu code cập nhật của Context7 trực tiếp trong Augment Code.---+### **B. Cấu hình Thủ công**1. Nhấn Cmd/Ctrl Shift P hoặc đi đến menu hamburger trong panel Augment2. Chọn Edit Settings@@ -408,10 +463,14 @@ Sau khi MCP server được thêm, bạn có thể bắt đầu sử dụng các}Sau khi MCP server được thêm, khởi động lại editor của bạn. Nếu bạn nhận được bất kỳ lỗi nào, kiểm tra cú pháp để đảm bảo không thiếu dấu ngoặc đóng hoặc dấu phẩy.</details>+<details><summary><b>Cài đặt trong Roo Code</b></summary>+Thêm cấu hình này vào file cấu hình Roo Code MCP của bạn. Xem [tài liệu Roo Code MCP](https://docs.roocode.com/features/mcp/using-mcp-in-roo) để biết thêm thông tin.+#### Kết nối Roo Code Remote Server+```json{"mcpServers": {@@ -422,7 +481,9 @@ Thêm cấu hình này vào file cấu hình Roo Code MCP của bạn. Xem [tài}}```+#### Kết nối Roo Code Local Server+```json{"mcpServers": {@@ -434,8 +495,10 @@ Thêm cấu hình này vào file cấu hình Roo Code MCP của bạn. Xem [tài}```</details>+<details><summary><b>Cài đặt trong Zencoder</b></summary>+Để cấu hình Context7 MCP trong Zencoder, làm theo các bước sau:1. Đi đến menu Zencoder (...)2. Từ menu dropdown, chọn Agent tools@@ -449,8 +512,10 @@ Thêm cấu hình này vào file cấu hình Roo Code MCP của bạn. Xem [tài```Sau khi MCP server được thêm, bạn có thể dễ dàng tiếp tục sử dụng nó.</details>+<details><summary><b>Cài đặt trong Amazon Q Developer CLI</b></summary>+Thêm cấu hình này vào file cấu hình Amazon Q Developer CLI của bạn. Xem [tài liệu Amazon Q Developer CLI](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-configuration.html) để biết thêm chi tiết.```json{@@ -463,8 +528,10 @@ Thêm cấu hình này vào file cấu hình Amazon Q Developer CLI của bạn.}```</details>+<details><summary><b>Cài đặt trong Qodo Gen</b></summary>+Xem [tài liệu Qodo Gen](https://docs.qodo.ai/qodo-documentation/qodo-gen/qodo-gen-chat/agentic-mode/agentic-tools-mcps) để biết thêm chi tiết.1. Mở panel chat Qodo Gen trong VSCode hoặc IntelliJ.2. Click Connect more tools.@@ -480,8 +547,10 @@ Xem [tài liệu Qodo Gen](https://docs.qodo.ai/qodo-documentation/qodo-gen/qodo}```</details>+<details><summary><b>Cài đặt trong JetBrains AI Assistant</b></summary>+Xem [Tài liệu JetBrains AI Assistant](https://www.jetbrains.com/help/ai-assistant/configure-an-mcp-server.html) để biết thêm chi tiết.1. Trong JetBrains IDEs đi đến `Settings` -> `Tools` -> `AI Assistant` -> `Model Context Protocol (MCP)`2. Click `+ Add`.@@ -500,8 +569,10 @@ Xem [Tài liệu JetBrains AI Assistant](https://www.jetbrains.com/help/ai-assis5. Click `Apply` để lưu thay đổi.6. Theo cách tương tự, context7 có thể được thêm cho JetBrains Junie trong `Settings` -> `Tools` -> `Junie` -> `MCP Settings`</details>+<details><summary><b>Cài đặt trong Warp</b></summary>+Xem [Tài liệu Warp Model Context Protocol](https://docs.warp.dev/knowledge-and-collaboration/mcp#adding-an-mcp-server) để biết chi tiết.1. Điều hướng `Settings` > `AI` > `Manage MCP servers`.2. Thêm MCP server mới bằng cách click nút `+ Add`.@@ -519,10 +590,14 @@ Xem [Tài liệu Warp Model Context Protocol](https://docs.warp.dev/knowledge-an```4. Click `Save` để áp dụng thay đổi.</details>+<details><summary><b>Cài đặt trong Opencode</b></summary>+Thêm cấu hình này vào file cấu hình Opencode của bạn. Xem [tài liệu Opencode MCP](https://opencode.ai/docs/mcp-servers) để biết thêm thông tin.+#### Kết nối Opencode Remote Server+```json"mcp": {"context7": {@@ -532,7 +607,9 @@ Thêm cấu hình này vào file cấu hình Opencode của bạn. Xem [tài li}}```+#### Kết nối Opencode Local Server+```json{"mcp": {@@ -545,8 +622,10 @@ Thêm cấu hình này vào file cấu hình Opencode của bạn. Xem [tài li}```</details>+<details><summary><b>Cài đặt trong Copilot Coding Agent</b></summary>+## Sử dụng Context7 với Copilot Coding AgentThêm cấu hình sau vào phần `mcp` trong file cấu hình Copilot Coding Agent của bạn Repository->Settings->Copilot->Coding agent->MCP configuration:```json@@ -562,8 +641,10 @@ Thêm cấu hình sau vào phần `mcp` trong file cấu hình Copilot Coding Ag```Để biết thêm thông tin, xem [tài liệu GitHub chính thức](https://docs.github.com/en/enterprise-cloud@latest/copilot/how-tos/agents/copilot-coding-agent/extending-copilot-coding-agent-with-mcp).</details>+<details><summary><b>Cài đặt trong Copilot CLI</b></summary>+1. Mở file cấu hình MCP của Copilot CLI. Vị trí là `~/.copilot/mcp-config.json` (trong đó `~` là thư mục home của bạn).2. Thêm nội dung sau vào đối tượng `mcpServers` trong file `mcp-config.json` của bạn:```json@@ -595,8 +676,10 @@ Hoặc, đối với server cục bộ:```Nếu file `mcp-config.json` không tồn tại, hãy tạo nó.</details>+<details><summary><b>Cài đặt trong Kiro</b></summary>+Xem [Tài liệu Kiro Model Context Protocol](https://kiro.dev/docs/mcp/configuration/) để biết chi tiết.1. Điều hướng `Kiro` > `MCP Servers`2. Thêm MCP server mới bằng cách click nút `+ Add`.@@ -616,28 +699,38 @@ Xem [Tài liệu Kiro Model Context Protocol](https://kiro.dev/docs/mcp/configur```4. Click `Save` để áp dụng thay đổi.</details>+<details><summary><b>Cài đặt trong OpenAI Codex</b></summary>+Xem [OpenAI Codex](https://github.com/openai/codex) để biết thêm thông tin.Thêm cấu hình sau vào cài đặt OpenAI Codex MCP server của bạn:+#### Kết nối Server Cục bộ+```toml[mcp_servers.context7]args = ["-y", "@upstash/context7-mcp"]command = "npx"```+#### Kết nối Server Từ xa+```toml[mcp_servers.context7]url = "https://mcp.context7.com/mcp"http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }```</details>+<details><summary><b>Cài đặt trong LM Studio</b></summary>+Xem [LM Studio MCP Support](https://lmstudio.ai/blog/lmstudio-v0.3.17) để biết thêm thông tin.+#### Cài đặt một cú click:[](https://lmstudio.ai/install-mcp?name=context7&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkB1cHN0YXNoL2NvbnRleHQ3LW1jcCJdfQ%3D%3D)+#### Thiết lập thủ công:1. Điều hướng đến `Program` (bên phải) > `Install` > `Edit mcp.json`.2. Paste cấu hình được cung cấp bên dưới:@@ -654,6 +747,7 @@ Xem [LM Studio MCP Support](https://lmstudio.ai/blog/lmstudio-v0.3.17) để bi3. Click `Save` để áp dụng thay đổi.4. Bật/tắt MCP server từ bên phải, dưới `Program`, hoặc bằng cách click biểu tượng plug ở cuối hộp chat.</details>+## 🔨 Công Cụ Có SẵnContext7 MCP cung cấp các công cụ sau mà LLM có thể sử dụng:- `resolve-library-id`: Chuyển đổi tên thư viện chung thành Context7-compatible library ID.@@ -662,7 +756,9 @@ Context7 MCP cung cấp các công cụ sau mà LLM có thể sử dụng:- `query-docs`: Lấy tài liệu cho thư viện sử dụng Context7-compatible library ID.- `libraryId` (bắt buộc): Context7-compatible library ID chính xác (ví dụ: `/mongodb/docs`, `/vercel/next.js`)- `query` (bắt buộc): Câu hỏi hoặc nhiệm vụ để lấy tài liệu liên quan+## 🛟 Mẹo+### Thêm Quy Tắc> Nếu bạn không muốn thêm `use context7` vào mỗi prompt, bạn có thể định nghĩa một quy tắc đơn giản trong file `.windsurfrules` của bạn trong Windsurf hoặc từ phần `Cursor Settings > Rules` trong Cursor (hoặc tương đương trong MCP client của bạn) để tự động gọi Context7 trên bất kỳ câu hỏi code nào:>@@ -673,6 +769,7 @@ Context7 MCP cung cấp các công cụ sau mà LLM có thể sử dụng:> ```>> Từ đó bạn sẽ nhận được tài liệu Context7 trong bất kỳ cuộc hội thoại liên quan nào mà không cần gõ thêm gì. Bạn có thể thêm các trường hợp sử dụng của mình vào phần match.+### Sử dụng Library Id> Nếu bạn đã biết chính xác thư viện nào muốn sử dụng, hãy thêm Context7 ID của nó vào prompt của bạn. Cách đó, Context7 MCP server có thể bỏ qua bước matching thư viện và trực tiếp tiếp tục với việc lấy tài liệu.>@@ -681,6 +778,7 @@ Context7 MCP cung cấp các công cụ sau mà LLM có thể sử dụng:> ```>> Cú pháp dấu gạch chéo nói với MCP tool chính xác thư viện nào cần load tài liệu.+## 💻 Phát TriểnClone dự án và cài đặt dependencies:```bash@@ -694,6 +792,7 @@ Chạy server:```bashnode packages/mcp/dist/index.js```+### Tham Số CLI`context7-mcp` chấp nhận các CLI flags sau:- `--transport <stdio|http>` – Transport để sử dụng (`stdio` theo mặc định).@@ -704,6 +803,7 @@ node packages/mcp/dist/index.js --transport http --port 8080```<details><summary><b>Ví dụ Cấu hình Local</b></summary>+```json{"mcpServers": {@@ -715,15 +815,19 @@ node packages/mcp/dist/index.js --transport http --port 8080}```</details>+<details><summary><b>Test với MCP Inspector</b></summary>+```bashnpx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp```</details>+## 🚨 Khắc Phục Sự Cố<details><summary><b>Lỗi Module Not Found</b></summary>+Nếu bạn gặp `ERR_MODULE_NOT_FOUND`, thử sử dụng `bunx` thay vì `npx`:```json{@@ -737,8 +841,10 @@ Nếu bạn gặp `ERR_MODULE_NOT_FOUND`, thử sử dụng `bunx` thay vì `npx```Điều này thường giải quyết các vấn đề phân giải module trong môi trường mà `npx` không cài đặt hoặc phân giải packages đúng cách.</details>+<details><summary><b>Vấn đề ESM Resolution</b></summary>+Đối với lỗi như `Error: Cannot find module 'uriTemplate.js'`, thử flag `--experimental-vm-modules`:```json{@@ -751,8 +857,10 @@ Nếu bạn gặp `ERR_MODULE_NOT_FOUND`, thử sử dụng `bunx` thay vì `npx}```</details>+<details><summary><b>Vấn đề TLS/Certificate</b></summary>+Sử dụng flag `--experimental-fetch` để vượt qua các vấn đề liên quan đến TLS:```json{@@ -765,20 +873,25 @@ Sử dụng flag `--experimental-fetch` để vượt qua các vấn đề liên}```</details>+<details><summary><b>Lỗi MCP Client Chung</b></summary>+1. Thử thêm `@latest` vào tên package2. Sử dụng `bunx` như một thay thế cho `npx`3. Cân nhắc sử dụng `deno` như một thay thế khác4. Đảm bảo bạn đang sử dụng Node.js v18 trở lên để hỗ trợ native fetch</details>+## ⚠️ Tuyên Bố Miễn Trừ Trách NhiệmCác dự án Context7 được đóng góp bởi cộng đồng và mặc dù chúng tôi cố gắng duy trì chất lượng cao, chúng tôi không thể đảm bảo tính chính xác, đầy đủ hoặc bảo mật của tất cả tài liệu thư viện. Các dự án được liệt kê trong Context7 được phát triển và duy trì bởi các chủ sở hữu tương ứng của họ, không phải bởi Context7. Nếu bạn gặp bất kỳ nội dung đáng ngờ, không phù hợp hoặc có khả năng gây hại nào, vui lòng sử dụng nút "Report" trên trang dự án để thông báo cho chúng tôi ngay lập tức. Chúng tôi xem xét tất cả các báo cáo một cách nghiêm túc và sẽ xem xét nội dung được gắn cờ kịp thời để duy trì tính toàn vẹn và an toàn của nền tảng. Bằng cách sử dụng Context7, bạn thừa nhận rằng bạn làm như vậy theo quyết định và rủi ro của riêng mình.+## 🤝 Kết Nối Với Chúng TôiCập nhật và tham gia cộng đồng của chúng tôi:- 📢 Theo dõi chúng tôi trên [X](https://x.com/context7ai) để có tin tức và cập nhật mới nhất- 🌐 Truy cập [Website](https://context7.com) của chúng tôi- 💬 Tham gia [Discord Community](https://upstash.com/discord) của chúng tôi+## 📺 Context7 Trên Truyền Thông- [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)@@ -788,7 +901,9 @@ Cập nhật và tham gia cộng đồng của chúng tôi:- [Income Stream Surfers: "Context7: The New MCP Server That Will CHANGE AI Coding"](https://www.youtube.com/watch?v=PS-2Azb-C3M)- [AICodeKing: "Context7 + Cline & RooCode: This MCP Server Makes CLINE 100X MORE EFFECTIVE!"](https://www.youtube.com/watch?v=qZfENAPMnyo)- [Sean Kochel: "5 MCP Servers For Vibe Coding Glory (Just Plug-In & Go)"](https://www.youtube.com/watch?v=LqTQi8qexJM)+## ⭐ Lịch Sử Star[](https://www.star-history.com/#upstash/context7&Date)+## 📄 Giấy PhépMITdiff --git a/i18n/README.zh-CN.md b/i18n/README.zh-CN.mdindex ea54cac5..45924979 100644--- a/i18n/README.zh-CN.md+++ b/i18n/README.zh-CN.md@@ -47,6 +47,7 @@ Context7将最新的代码示例和文档直接获取到你的LLM上下文中。- Context7 API密钥(可选,用于更高的请求速率限制)(通过在[context7.com/dashboard](https://context7.com/dashboard)创建账户获取)<details><summary><b>通过 Smithery 安装</b></summary>+通过 [Smithery](https://smithery.ai/server/@upstash/context7-mcp) 为任何客户端自动安装 Context7 MCP 服务器:```bash@@ -56,11 +57,14 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>你可以在 [Smithery.ai 网页](https://smithery.ai/server/@upstash/context7-mcp)中找到你的 Smithery 密钥。</details>+<details><summary><b>在 Cursor 中安装</b></summary>+前往:`Settings` -> `Cursor Settings` -> `MCP` -> `Add new global MCP server`推荐将以下配置粘贴到你的 Cursor `~/.cursor/mcp.json` 文件中。你也可以通过在项目文件夹中创建 `.cursor/mcp.json` 在特定项目中安装。更多信息请参阅 [Cursor MCP 文档](https://docs.cursor.com/context/model-context-protocol)。> 自 Cursor 1.0 起,你可以点击下面的安装按钮进行即时一键安装。+#### Cursor 远程服务器连接[](https://cursor.com/en/install-mcp?name=context7&config=eyJ1cmwiOiJodHRwczovL21jcC5jb250ZXh0Ny5jb20vbWNwIn0%3D)```json@@ -75,6 +79,7 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}}```+#### Cursor 本地服务器连接[](https://cursor.com/en/install-mcp?name=context7&config=eyJjb21tYW5kIjoibnB4IC15IEB1cHN0YXNoL2NvbnRleHQ3LW1jcCJ9)```json@@ -88,22 +93,32 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}```</details>+<details><summary><b>在 Claude Code 中安装</b></summary>+运行以下命令。更多信息请参见 [Claude Code MCP 文档](https://docs.anthropic.com/zh-CN/docs/claude-code/mcp)。+#### Claude Code 本地服务器连接+```shclaude mcp add context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY```+#### Claude Code 远程服务器连接+```shclaude mcp add --header "CONTEXT7_API_KEY: YOUR_API_KEY" --transport http context7 https://mcp.context7.com/mcp```</details>+<details><summary><b>在 Windsurf 中安装</b></summary>+将此内容添加到你的 Windsurf MCP 配置文件中。更多信息请参阅 [Windsurf MCP 文档](https://docs.windsurf.com/windsurf/cascade/mcp)。+#### Windsurf 远程服务器连接+```json{"mcpServers": {@@ -116,7 +131,9 @@ claude mcp add --header "CONTEXT7_API_KEY: YOUR_API_KEY" --transport http contex}}```+#### Windsurf 本地服务器连接+```json{"mcpServers": {@@ -128,12 +145,16 @@ claude mcp add --header "CONTEXT7_API_KEY: YOUR_API_KEY" --transport http contex}```</details>+<details><summary><b>在 VS Code 中安装</b></summary>+[<img alt="在 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)[<img alt="在 VS Code Insiders 中安装 (npx)" src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Install%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)将此内容添加到你的 VS Code MCP 配置文件中。更多信息请参阅 [VS Code MCP 文档](https://code.visualstudio.com/docs/copilot/chat/mcp-servers)。+#### VS Code 远程服务器连接+```json"mcp": {"servers": {@@ -147,7 +168,9 @@ claude mcp add --header "CONTEXT7_API_KEY: YOUR_API_KEY" --transport http contex}}```+#### VS Code 本地服务器连接+```json"mcp": {"servers": {@@ -160,10 +183,12 @@ claude mcp add --header "CONTEXT7_API_KEY: YOUR_API_KEY" --transport http contex}```</details>+<details><summary><b>在 Cline 中安装</b></summary>+您可以通过以下步骤轻松地通过 [Cline MCP Server 市场](https://cline.bot/mcp-marketplace) 安装 Context7:1. 打开 **Cline**。2. 点击菜单图标 (☰),进入 **MCP 服务器** 部分。@@ -189,8 +214,10 @@ claude mcp add --header "CONTEXT7_API_KEY: YOUR_API_KEY" --transport http contex}```</details>+<details><summary><b>在 Zed 中安装</b></summary>+它可以通过 [Zed Extensions](https://zed.dev/extensions?query=Context7) 安装,或者您也可以将以下内容添加到您的 Zed `settings.json` 中。更多信息请参见 [Zed Context Server 文档](https://zed.dev/docs/assistant/context-servers)。```json{@@ -204,9 +231,12 @@ claude mcp add --header "CONTEXT7_API_KEY: YOUR_API_KEY" --transport http contex}```</details>+<details><summary><b>在 Augment Code 中安装</b></summary>+要在 Augment Code 中配置 Context7 MCP,您可以使用图形界面或手动配置两种方式。+### **A. 在 Augment Code Code UI 中使用**1. 点击 hamburger 菜单。2. 选择 **Settings**。@@ -220,6 +250,7 @@ claude mcp add --header "CONTEXT7_API_KEY: YOUR_API_KEY" --transport http contex7. 点击 **Add** 按钮。添加 MCP 服务器后,您即可在 Augment Code 内直接使用 Context7 提供的最新代码文档功能。---+### **B. 手动配置**1. 按下 Cmd/Ctrl + Shift + P,或在 Augment 面板点击 hamburger 菜单。2. 选择编辑设置 (Edit Settings)。@@ -238,10 +269,14 @@ claude mcp add --header "CONTEXT7_API_KEY: YOUR_API_KEY" --transport http contex```添加 MCP 服务器后,重启编辑器。如果收到任何错误,请检查语法,确保没有缺少关闭括号或逗号。</details>+<details><summary><b>在 Roo Code 中安装</b></summary>+将此内容添加到您的 Roo Code MCP 配置文件中。更多信息请参见 [Roo Code MCP 文档](https://docs.roocode.com/features/mcp/using-mcp-in-roo)。+#### Roo Code 远程服务器连接+```json{"mcpServers": {@@ -252,7 +287,9 @@ claude mcp add --header "CONTEXT7_API_KEY: YOUR_API_KEY" --transport http contex}}```+#### Roo Code 本地服务器连接+```json{"mcpServers": {@@ -264,8 +301,10 @@ claude mcp add --header "CONTEXT7_API_KEY: YOUR_API_KEY" --transport http contex}```</details>+<details><summary><b>在 Gemini CLI 中安装</b></summary>+详细信息请参阅 [Gemini CLI 配置](https://google-gemini.github.io/gemini-cli/docs/tools/mcp-server.html)。1. 打开 Gemini CLI 设置文件。位置是 `~/.gemini/settings.json`(其中 `~` 是你的主目录)。2. 将以下内容添加到你的 `settings.json` 文件中的 `mcpServers` 对象:@@ -294,10 +333,13 @@ claude mcp add --header "CONTEXT7_API_KEY: YOUR_API_KEY" --transport http contex```如果 `mcpServers` 对象不存在,请创建它。</details>+<details><summary><b>在 Claude Desktop 中安装</b></summary>+#### 远程服务器连接打开 Claude Desktop,进入【设置】>【连接器】>【添加自定义连接器】,将名称填写为 `Context7`,远程 MCP 服务器 URL 填写为 `https://mcp.context7.com/mcp`。+#### 本地服务器连接打开 Claude Desktop 开发者设置,编辑您的 `claude_desktop_config.json` 文件,添加以下配置。更多信息请参见 [Claude Desktop MCP 文档](https://modelcontextprotocol.io/quickstart/user)。```json@@ -311,10 +353,14 @@ claude mcp add --header "CONTEXT7_API_KEY: YOUR_API_KEY" --transport http contex}```</details>+<details><summary><b>在 Opencode 中安装</b></summary>+将此内容添加到您的 Opencode 配置文件中。更多信息请参见 [Opencode MCP 文档](https://opencode.ai/docs/mcp-servers)。+#### Opencode 远程服务器连接+```json"mcp": {"context7": {@@ -327,7 +373,9 @@ claude mcp add --header "CONTEXT7_API_KEY: YOUR_API_KEY" --transport http contex}}```+#### Opencode 本地服务器连接+```json{"mcp": {@@ -340,25 +388,33 @@ claude mcp add --header "CONTEXT7_API_KEY: YOUR_API_KEY" --transport http contex}```</details>+<details><summary><b>在 OpenAI Codex 中安装</b></summary>+更多信息请参见 [OpenAI Codex](https://github.com/openai/codex)。将以下配置添加到您的 OpenAI Codex MCP 服务器设置中:+#### 本地服务器连接+```toml[mcp_servers.context7]args = ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]command = "npx"```+#### 远程服务器连接+```toml[mcp_servers.context7]url = "https://mcp.context7.com/mcp"http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }```</details>+<details><summary><b>在 JetBrains AI Assistant 中安装</b></summary>+更多详情请参见 [JetBrains AI Assistant 文档](https://www.jetbrains.com/help/ai-assistant/configure-an-mcp-server.html)。1. 在 JetBrains IDE 中,进入 `Settings` -> `Tools` -> `AI Assistant` -> `Model Context Protocol (MCP)`。2. 点击 `+ Add`。@@ -377,8 +433,10 @@ http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }5. 点击 应用 以保存更改。6. 同样的方法可以在 `Settings` -> `Tools` -> `Junie` -> `MCP Settings` 中为 JetBrains Junie 添加 context7。</details>+<details><summary><b>在 Kiro 中安装</b></summary>+详情请见 [Kiro 模型上下文协议文档](https://kiro.dev/docs/mcp/configuration/)。1. 进入 `Kiro` > `MCP Servers`2. 点击 `+ Add` 按钮,新增一个 MCP 服务器。@@ -398,11 +456,15 @@ http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }```4. 点击 `Save` 以应用更改。</details>+<details><summary><b>在 Trae 中安装</b></summary>+使用“手动添加”功能,填写该 MCP 服务器的 JSON 配置信息。更多详情请访问 [Trae 文档](https://docs.trae.ai/ide/model-context-protocol?_lang=en)。+#### Trae 远程服务器连接+```json{"mcpServers": {@@ -412,7 +474,9 @@ http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }}}```+#### Trae 本地服务器连接+```json{"mcpServers": {@@ -424,10 +488,14 @@ http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }}```</details>+<details><summary><b>在 Bun 或 Deno 中使用</b></summary>+使用以下替代方法,在其他运行环境中运行本地 Context7 MCP 服务器。这些示例适用于任何支持通过命令 + 参数启动本地 MCP 服务器的客户端。+#### Bun+```json{"mcpServers": {@@ -438,7 +506,9 @@ http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }}}```+#### Deno+```json{"mcpServers": {@@ -455,13 +525,16 @@ http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }}```</details>+<details><summary><b>使用 Docker</b></summary>+如果你更喜欢在 Docker 容器中运行 MCP 服务器:1. **构建 Docker 镜像:**首先,在项目根目录(或任何你喜欢的地方)创建一个 `Dockerfile`:<details><summary>点击查看 Dockerfile 内容</summary>+```DockerfileFROM node:18-alpineWORKDIR /app@@ -473,6 +546,7 @@ http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }CMD ["context7-mcp"]```</details>+然后,使用标签(例如,`context7-mcp`)构建镜像。**确保 Docker Desktop(或 Docker 守护进程)正在运行。** 在保存 `Dockerfile` 的同一目录中运行以下命令:```bashdocker build -t context7-mcp .@@ -496,12 +570,16 @@ http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }```_注意:这是一个示例配置。请参考前面 README 中针对你的 MCP 客户端(如 Cursor、VS Code 等)的具体示例来调整结构(例如,`mcpServers` 与 `servers`)。另外,确保 `args` 中的镜像名称与 `docker build` 命令期间使用的标签匹配。_</details>+<details><summary><b>使用桌面扩展安装</b></summary>+安装 dxt 文件夹下的 [context7.dxt](dxt/context7.dxt) 文件并将其添加到你的客户端。更多信息请查看[桌面扩展文档](https://github.com/anthropics/dxt#desktop-extensions-dxt)。</details>+<details><summary><b>在 Windows 中安装</b></summary>+在 Windows 上的配置与 Linux 或 macOS 略有不同(_示例中使用了 `Cline`_), 其它编辑器同理, 参考`command`和`args`的配置即可。```json{@@ -516,8 +594,10 @@ http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }}```</details>+<details><summary><b>在 Amazon Q Developer CLI 中安装</b></summary>+将以下内容添加到您的 Amazon Q Developer CLI 配置文件中。更多详情请参见 [Amazon Q Developer CLI 文档](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-configuration.html)。```json{@@ -530,8 +610,10 @@ http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }}```</details>+<details><summary><b>在 Warp 中安装</b></summary>+详情请参见 [Warp 模型上下文协议文档](https://docs.warp.dev/knowledge-and-collaboration/mcp#adding-an-mcp-server)。1. 进入 `Settings` > `AI` > `Manage MCP servers`。2. 点击 `+ Add` 按钮,新增一个 MCP 服务器。@@ -549,8 +631,10 @@ http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }```4. 点击 `Save` 按钮以应用更改。</details>+<details><summary><b>在 Copilot Coding Agent 中安装</b></summary>+## 在 Copilot Coding Agent 中使用 Context7将以下配置添加到您的Copilot编码代理配置文件的 `mcp` 部分,路径为 Repository->Settings->Copilot->Coding agent->MCP configuration:```json@@ -569,8 +653,10 @@ http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }```更多信息请见 [官方 GitHub 文档](https://docs.github.com/zh/enterprise-cloud@latest/copilot/how-tos/agents/copilot-coding-agent/extending-copilot-coding-agent-with-mcp)。</details>+<details><summary><b>在 Copilot CLI 中安装</b></summary>+1. 打开 Copilot CLI MCP 配置文件。文件位置是 `~/.copilot/mcp-config.json`(其中 `~` 是你的主目录)。2. 将以下内容添加到 `mcp-config.json` 文件中的 `mcpServers` 对象:```json@@ -602,11 +688,15 @@ http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }```如果 `mcp-config.json` 文件不存在,请创建它。</details>+<details><summary><b>在 LM Studio 中安装</b></summary>+更多详情请参见 [LM Studio MCP 支持](https://lmstudio.ai/blog/lmstudio-v0.3.17)。+#### 一键安装:[](https://lmstudio.ai/install-mcp?name=context7&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkB1cHN0YXNoL2NvbnRleHQ3LW1jcCJdfQ%3D%3D)+#### 手动设置:1. 进入 `Program`(右侧)> `Install` > `Edit mcp.json`。2. 粘贴以下配置内容:@@ -623,8 +713,10 @@ http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }3. 点击 `Save` 应用更改。4. 在右侧的 `Program` 下,或通过点击聊天框底部的插头图标,切换 MCP 服务器的开关。</details>+<details><summary><b>在 Visual Studio 2022 中安装</b></summary>+您可以按照[Visual Studio MCP 服务器文档](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022)中的说明,在 Visual Studio 2022 中配置 Context7 MCP。将此添加到您的 Visual Studio MCP 配置文件中(详细信息请参阅[Visual Studio 文档](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022)):```json@@ -655,14 +747,18 @@ http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }```有关更多信息和故障排除,请参阅[Visual Studio MCP 服务器文档](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022)。</details>+<details><summary><b>在 Crush 中安装</b></summary>+将此添加到您的 Crush 配置文件中。更多信息请参见 [Crush MCP 文档](https://github.com/charmbracelet/crush#mcps)。1. 转到 Zencoder 菜单 (...)2. 从下拉菜单中选择代理工具3. 点击添加自定义 MCP4. 从下面添加名称和服务器配置,并确保点击安装按钮+#### Crush 远程服务器连接+```json{"$schema": "https://charm.land/crush.json",@@ -677,7 +773,9 @@ http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }}}```+#### Crush 本地服务器连接+```json{"$schema": "https://charm.land/crush.json",@@ -691,8 +789,10 @@ http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }}```</details>+<details><summary><b>在 BoltAI 中安装</b></summary>+打开应用的“Settings”页面,导航到“Plugins”,然后输入以下 JSON:```json{@@ -706,14 +806,18 @@ http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }```保存后,在聊天中输入 `query-docs`,后跟您的 Context7 文档 ID(例如,`query-docs /nuxt/ui`)。更多信息请访问 [BoltAI 的文档网站](https://docs.boltai.com/docs/plugins/mcp-servers)。有关 iOS 版 BoltAI,请参见[此指南](https://docs.boltai.com/docs/boltai-mobile/mcp-servers)。</details>+<details><summary><b>在 Rovo Dev CLI 中安装</b></summary>+通过运行以下命令编辑您的 Rovo Dev CLI MCP 配置 -```bashacli rovodev mcp```示例配置 -+#### 远程服务器连接+```json{"mcpServers": {@@ -723,7 +827,9 @@ acli rovodev mcp}}```+#### 本地服务器连接+```json{"mcpServers": {@@ -735,8 +841,10 @@ acli rovodev mcp}```</details>+<details><summary><b>在 Zencoder 中安装</b></summary>+要在 Zencoder 中配置 Context7 MCP,请按照以下步骤操作:1. 进入 Zencoder 菜单(...)2. 从下拉菜单中选择 Agent tools@@ -750,14 +858,18 @@ acli rovodev mcp```一旦添加了MCP服务器,您就可以轻松继续使用它。</details>+<details><summary><b>在 Qodo Gen 中安装</b></summary>+详见 [Qodo Gen 文档](https://docs.qodo.ai/qodo-documentation/qodo-gen/qodo-gen-chat/agentic-mode/agentic-tools-mcps)。1. 在 VSCode 或 IntelliJ 中打开 Qodo Gen 聊天面板。2. 点击 Connect more tools 。3. 点击 + Add new MCP 。4. 添加以下配置:+#### Qodo Gen 本地服务器连接+```json{"mcpServers": {@@ -768,7 +880,9 @@ acli rovodev mcp}}```+#### Qodo Gen 远程服务器连接+```json{"mcpServers": {@@ -779,8 +893,10 @@ acli rovodev mcp}```</details>+<details><summary><b>在 Perplexity Desktop 中安装</b></summary>+更多信息请参阅 [Perplexity 的本地和远程 MCP](https://www.perplexity.ai/help-center/en/articles/11502712-local-and-remote-mcps-for-perplexity)。1. 导航 `Perplexity` > `设置`2. 选择 `连接器`。@@ -797,6 +913,7 @@ acli rovodev mcp```7. 点击 `保存`。</details>+## 🔨 可用工具Context7 MCP 提供以下 LLM 可以使用的工具:- `resolve-library-id`:将通用库名称解析为 Context7 兼容的库 ID。@@ -805,7 +922,9 @@ Context7 MCP 提供以下 LLM 可以使用的工具:- `query-docs`:使用 Context7 兼容的库 ID 获取库的文档。- `libraryId`(必需):精确的 Context7 兼容库 ID(例如,`/mongodb/docs`、`/vercel/next.js`)- `query`(必需):用于获取相关文档的问题或任务+## 🛟 技巧+### 添加规则> 如果你不想在每个提示中添加 `use context7`,你可以在 Windsurf 的 `.windsurfrules` 文件中或从 Cursor 的 `Cursor Settings > Rules` 部分(或你的 MCP 客户端中的等效位置)定义一个简单规则,以在任何代码问题上自动调用 Context7:>@@ -816,6 +935,7 @@ Context7 MCP 提供以下 LLM 可以使用的工具:> ```>> 从那时起,你将在任何相关对话中获得 Context7 的文档,而无需键入任何额外内容。你可以将你的用例添加到匹配部分。+### 使用库 ID> 如果你已经确切地知道要使用哪个库,请将其 Context7 ID 添加到你的提示中。这样,Context7 MCP 服务器可以跳过库匹配步骤,直接继续检索文档。>@@ -824,6 +944,7 @@ Context7 MCP 提供以下 LLM 可以使用的工具:> ```>> 斜杠语法告诉 MCP 工具确切要为哪个库加载文档。+## 💻 开发克隆项目并安装依赖:```bash@@ -837,6 +958,7 @@ pnpm run build```bashnode packages/mcp/dist/index.js```+### CLI 参数`context7-mcp` 接受以下 CLI 标志:- `--transport <stdio|http>` – 使用的传输方式(默认 `stdio`)。使用 `http` 作为远程 HTTP 服务器或 `stdio` 用于本地集成。@@ -852,6 +974,7 @@ node packages/mcp/dist/index.js --transport stdio --api-key YOUR_API_KEY```<details><summary><b>本地配置示例</b></summary>+```json{"mcpServers": {@@ -863,15 +986,19 @@ node packages/mcp/dist/index.js --transport stdio --api-key YOUR_API_KEY}```</details>+<details><summary><b>使用 MCP Inspector 测试</b></summary>+```bashnpx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp```</details>+## 🚨 故障排除<details><summary><b>模块未找到错误(ERR_MODULE_NOT_FOUND)</b></summary>+如果你遇到 `ERR_MODULE_NOT_FOUND`,请尝试使用 `bunx` 而不是 `npx`:```json{@@ -885,8 +1012,10 @@ npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp```这通常可以解决模块解析问题,特别是在`npx`无法正确安装或解析包的环境中。</details>+<details><summary><b>ESM 解析问题</b></summary>+对于像 `Error: Cannot find module 'uriTemplate.js'` 这样的错误,请尝试 `--experimental-vm-modules` 标志:```json{@@ -899,8 +1028,10 @@ npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp}```</details>+<details><summary><b>TLS/证书问题</b></summary>+使用 `--experimental-fetch` 标志绕过 TLS 相关问题:```json{@@ -913,20 +1044,25 @@ npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp}```</details>+<details><summary><b>通用 MCP 客户端错误</b></summary>+1. 尝试在包名中添加 `@latest` 。2. 尝试使用`bunx`作为替代方案。3. 尝试使用`deno`作为替代方案。4. 确保你使用的是Node v18或更高版本,以便使用`npx`时获得原生fetch支持。</details>+## ⚠️ 免责声明Context7 项目由社区贡献,虽然我们努力保持高质量,但我们不能保证所有库文档的准确性、完整性或安全性。Context7 中列出的项目由其各自的所有者开发和维护,而不是由 Context7 开发和维护。如果你遇到任何可疑、不当或潜在有害的内容,请使用项目页面上的"举报"按钮立即通知我们。我们认真对待所有举报,并将及时审查标记的内容,以维护我们平台的完整性和安全性。通过使用 Context7,你承认你是自行判断和承担风险的。+## 🤝 与我们联系保持更新并加入我们的社区:- 📢 在 [X](https://x.com/context7ai) 上关注我们获取最新新闻和更新- 🌐 访问我们的[网站](https://context7.com)- 💬 加入我们的 [Discord 社区](https://upstash.com/discord)+## 📺 Context7媒体报道- [Better Stack: "免费工具让 Cursor 智能 10 倍"](https://youtu.be/52FC3qObp9E)- [Cole Medin: "这绝对是 AI 编码助手的最佳 MCP 服务器"](https://www.youtube.com/watch?v=G7gK8H6u7Rs)@@ -936,7 +1072,9 @@ Context7 项目由社区贡献,虽然我们努力保持高质量,但我们- [Income Stream Surfers: "Context7:将改变 AI 编码的新 MCP 服务器"](https://www.youtube.com/watch?v=PS-2Azb-C3M)- [AICodeKing: "Context7 + Cline & RooCode:这个 MCP 服务器让 CLINE 效果提升 100 倍!"](https://www.youtube.com/watch?v=qZfENAPMnyo)- [Sean Kochel: "5 个让编码更爽的 MCP 服务器(即插即用)"](https://www.youtube.com/watch?v=LqTQi8qexJM)+## ⭐ Star 历史[](https://www.star-history.com/#upstash/context7&Date)+## 📄 许可证MITdiff --git a/i18n/README.zh-TW.md b/i18n/README.zh-TW.mdindex f4b00d92..5582e10d 100644--- a/i18n/README.zh-TW.md+++ b/i18n/README.zh-TW.md@@ -42,6 +42,7 @@ Context7 會將即時的程式碼範例與文件直接帶入你的 LLM 上下文- Cursor、Windsurf、Claude Desktop 或其他 MCP 客戶端<details><summary><b>透過 Smithery 安裝</b></summary>+要透過 [Smithery](https://smithery.ai/server/@upstash/context7-mcp) 自動安裝 Context7 MCP Server:```bash@@ -51,11 +52,15 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>你的 Smithery 金鑰可在 [Smithery.ai 網頁](https://smithery.ai/server/@upstash/context7-mcp) 取得。</details>+<details><summary><b>在 Cursor 安裝</b></summary>+前往:`Settings` -> `Cursor Settings` -> `MCP` -> `Add new global MCP server`建議將下列設定貼到你的 Cursor `~/.cursor/mcp.json` 檔案。你也可以在專案資料夾建立 `.cursor/mcp.json` 進行專案安裝。詳見 [Cursor MCP 文件](https://docs.cursor.com/context/model-context-protocol)。+#### Cursor 遠端伺服器連線+```json{"mcpServers": {@@ -65,6 +70,7 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}}```+#### Cursor 本地伺服器連線[](https://cursor.com/install-mcp?name=context7&config=eyJjb21tYW5kIjoibnB4IC15IEB1cHN0YXNoL2NvbnRleHQ3LW1jcCJ9)```json@@ -79,6 +85,7 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>```<details><summary>替代方案:使用 Bun</summary>+[](https://cursor.com/install-mcp?name=context7&config=eyJjb21tYW5kIjoiYnVueCAteSBAdXBzdGFzaC9jb250ZXh0Ny1tY3AifQ%3D%3D)```json{@@ -91,8 +98,10 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}```</details>+<details><summary>替代方案:使用 Deno</summary>+[](https://cursor.com/install-mcp?name=context7&config=eyJjb21tYW5kIjoiZGVubyBydW4gLS1hbGxvdy1lbnYgLS1hbGxvdy1uZXQgbnBtOkB1cHN0YXNoL2NvbnRleHQ3LW1jcCJ9)```json{@@ -105,11 +114,16 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}```</details>+</details>+<details><summary><b>在 Windsurf 安裝</b></summary>+將下列內容加入 Windsurf MCP 設定檔。詳見 [Windsurf MCP 文件](https://docs.windsurf.com/windsurf/mcp)。+#### Windsurf 遠端伺服器連線+```json{"mcpServers": {@@ -119,7 +133,9 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}}```+#### Windsurf 本地伺服器連線+```json{"mcpServers": {@@ -131,11 +147,15 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}```</details>+<details><summary><b>在 Trae 安裝</b></summary>+請使用「手動新增」功能,並填寫該 MCP 伺服器的 JSON 設定資訊。欲了解更多詳情,請參閱 [Trae 文件](https://docs.trae.ai/ide/model-context-protocol?_lang=zh-tw)。+#### Trae 遠端伺服器連線+```json{"mcpServers": {@@ -145,7 +165,9 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}}```+#### Trae 本地伺服器連線+```json{"mcpServers": {@@ -157,12 +179,16 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}```</details>+<details><summary><b>在 VS Code 安裝</b></summary>+[<img alt="在 VS Code 中安裝 (npx)" src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=安裝Context7%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="在 VS Code Insiders 中安裝 (npx)" src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=安裝Context7%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)將下列內容加入 VS Code MCP 設定檔。詳見 [VS Code MCP 文件](https://code.visualstudio.com/docs/copilot/chat/mcp-servers)。+#### VS Code 遠端伺服器連線+```json"mcp": {"servers": {@@ -173,7 +199,9 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}}```+#### VS Code 本地伺服器連線+```json"mcp": {"servers": {@@ -186,8 +214,10 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}```</details>+<details><summary><b>在 Visual Studio 2022 安裝</b></summary>+您可以按照 [Visual Studio MCP 伺服器文件](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022) 的說明,在 Visual Studio 2022 中設定 Context7 MCP。請將以下內容新增至您的 Visual Studio MCP 設定檔(詳細資訊請參閱 [Visual Studio 文件](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022)):```json@@ -218,8 +248,10 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>```如需更多資訊與疑難排解,請參閱 [Visual Studio MCP 伺服器文件](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022)。</details>+<details><summary><b>在 Zed 安裝</b></summary>+可透過 [Zed 擴充套件](https://zed.dev/extensions?query=Context7) 安裝,或將下列內容加入 Zed `settings.json`。詳見 [Zed Context Server 文件](https://zed.dev/docs/assistant/context-servers)。```json{@@ -233,8 +265,10 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}```</details>+<details><summary><b>在 Gemini CLI 安裝</b></summary>+詳閱 [Gemini CLI 設定說明](https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/configuration.md)。1. 開啟 Gemini CLI 設定檔,位置為 `~/.gemini/settings.json`(其中 `~` 代表您的家目錄)。2. 在您的 `settings.json` 檔案中的 `mcpServers` 物件內新增以下內容:@@ -260,20 +294,28 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>```如果 `mcpServers` 物件不存在,請建立它。</details>+<details><summary><b>在 Claude Code 安裝</b></summary>+執行下列指令。詳見 [Claude Code MCP 文件](https://docs.anthropic.com/zh-TW/docs/claude-code/mcp)。+#### Claude Code 本地伺服器連線+```shclaude mcp add context7 -- npx -y @upstash/context7-mcp```+#### Claude Code 遠端伺服器連線+```shclaude mcp add --transport http context7 https://mcp.context7.com/mcp```</details>+<details><summary><b>在 Claude Desktop 安裝</b></summary>+將下列內容加入 Claude Desktop `claude_desktop_config.json`。詳見 [Claude Desktop MCP 文件](https://modelcontextprotocol.io/quickstart/user)。```json{@@ -286,10 +328,12 @@ claude mcp add --transport http context7 https://mcp.context7.com/mcp}```</details>+<details><summary><b>在 Cline 安裝</b></summary>+您可以按照以下說明,透過 [Cline MCP 伺服器市集](https://cline.bot/mcp-marketplace) 輕鬆安裝 Context7:1. 開啟 **Cline**。2. 點擊選單圖示(☰)進入 **MCP 伺服器** 區段。@@ -315,8 +359,10 @@ claude mcp add --transport http context7 https://mcp.context7.com/mcp}```</details>+<details><summary><b>在 BoltAI 安裝</b></summary>+打開應用程式的「Settings」頁面,前往「Plugins」,並輸入下列 JSON:```json{@@ -330,8 +376,10 @@ claude mcp add --transport http context7 https://mcp.context7.com/mcp```儲存後,在聊天中輸入 `query-docs` 並接上你的 Context7 文件 ID(例如 `query-docs /nuxt/ui`)。更多資訊請參考 [BoltAI 文件網站](https://docs.boltai.com/docs/plugins/mcp-servers)。如在 iOS 上使用 BoltAI,請參考[此指南](https://docs.boltai.com/docs/boltai-mobile/mcp-servers)。</details>+<details><summary><b>在 Copilot Coding Agent 安裝</b></summary>+## 在 Copilot Coding Agent 使用 Context7請將以下設定加入 Copilot Coding Agent 的 `mcp` 設定區塊(Repository->Settings->Copilot->Coding agent->MCP configuration):```json@@ -347,8 +395,10 @@ claude mcp add --transport http context7 https://mcp.context7.com/mcp```更多資訊請參見[官方 GitHub 文件](https://docs.github.com/en/enterprise-cloud@latest/copilot/how-tos/agents/copilot-coding-agent/extending-copilot-coding-agent-with-mcp)。</details>+<details><summary><b>在 Copilot CLI 中安裝</b></summary>+1. 打開 Copilot CLI MCP 設定檔。位置為 `~/.copilot/mcp-config.json`(其中 `~` 是您的主目錄)。2. 在 `mcp-config.json` 檔案中的 `mcpServers` 物件新增下列内容:```json@@ -380,13 +430,16 @@ claude mcp add --transport http context7 https://mcp.context7.com/mcp```如果 `mcp-config.json` 檔案不存在,請建立它。</details>+<details><summary><b>使用 Docker</b></summary>+若你偏好在 Docker 容器中執行 MCP 伺服器:1. **建立 Docker 映像檔:**先在專案根目錄(或任意位置)建立 `Dockerfile`:<details><summary>點擊查看 Dockerfile 內容</summary>+```DockerfileFROM node:18-alpineWORKDIR /app@@ -398,6 +451,7 @@ claude mcp add --transport http context7 https://mcp.context7.com/mcpCMD ["context7-mcp"]```</details>+然後使用標籤(如 `context7-mcp`)建構映像檔。**請確保 Docker Desktop(或 Docker daemon)已啟動。**在存有 `Dockerfile` 的目錄執行:```bashdocker build -t context7-mcp .@@ -421,8 +475,10 @@ claude mcp add --transport http context7 https://mcp.context7.com/mcp```_注意:這是範例設定。請參考前述各 MCP 客戶端(如 Cursor、VS Code 等)的範例調整結構(如 `mcpServers` 與 `servers`)。同時確保 `args` 中的映像名稱與 `docker build` 使用的標籤一致。_</details>+<details><summary><b>在 Windows 安裝</b></summary>+Windows 的設定與 Linux 或 macOS 略有不同(_範例以 Cline 為例_)。其他編輯器同理,請參考 `command` 與 `args` 設定。```json{@@ -437,8 +493,10 @@ Windows 的設定與 Linux 或 macOS 略有不同(_範例以 Cline 為例_)}```</details>+<details><summary><b>在 Augment Code 安裝</b></summary>+在 Augment Code 設定 Context7 MCP,請依下列步驟:1. 按 Cmd/Ctrl Shift P 或於 Augment 面板的漢堡選單中選擇2. 選擇 Edit Settings@@ -457,10 +515,14 @@ Windows 的設定與 Linux 或 macOS 略有不同(_範例以 Cline 為例_)```加入 MCP 伺服器後,請重啟編輯器。如遇錯誤,請檢查語法是否有遺漏括號或逗號。</details>+<details><summary><b>在 Roo Code 安裝</b></summary>+將以下內容加入你的 Roo Code MCP 設定檔。更多資訊請參考 [Roo Code MCP 文件](https://docs.roocode.com/features/mcp/using-mcp-in-roo)。+#### Roo Code 遠端伺服器連線+```json{"mcpServers": {@@ -471,7 +533,9 @@ Windows 的設定與 Linux 或 macOS 略有不同(_範例以 Cline 為例_)}}```+#### Roo Code 本地伺服器連線+```json{"mcpServers": {@@ -483,8 +547,10 @@ Windows 的設定與 Linux 或 macOS 略有不同(_範例以 Cline 為例_)}```</details>+<details><summary><b>在 Zencoder 安裝</b></summary>+要在 Zencoder 設定 Context7 MCP,請依照下列步驟操作:1. 前往 Zencoder 選單(...)2. 從下拉選單選擇 Agent tools@@ -498,8 +564,10 @@ Windows 的設定與 Linux 或 macOS 略有不同(_範例以 Cline 為例_)```新增 MCP 伺服器後,即可繼續使用。</details>+<details><summary><b>在 Amazon Q Developer CLI 安裝</b></summary>+將以下內容加入你的 Amazon Q Developer CLI 設定檔。更多細節請參考 [Amazon Q Developer CLI 文件](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-configuration.html)。```json{@@ -512,8 +580,10 @@ Windows 的設定與 Linux 或 macOS 略有不同(_範例以 Cline 為例_)}```</details>+<details><summary><b>在 Qodo Gen 安裝</b></summary>+詳情請參考 [Qodo Gen 文件](https://docs.qodo.ai/qodo-documentation/qodo-gen/qodo-gen-chat/agentic-mode/agentic-tools-mcps)。1. 在 VSCode 或 IntelliJ 開啟 Qodo Gen 聊天面板。2. 點擊 Connect more tools。@@ -529,8 +599,10 @@ Windows 的設定與 Linux 或 macOS 略有不同(_範例以 Cline 為例_)}```</details>+<details><summary><b>在 JetBrains AI Assistant 安裝</b></summary>+詳情請參考 [JetBrains AI Assistant 文件](https://www.jetbrains.com/help/ai-assistant/configure-an-mcp-server.html)。1. 在 JetBrains IDE 前往 `Settings` -> `Tools` -> `AI Assistant` -> `Model Context Protocol (MCP)`2. 點擊 `+ Add`@@ -549,8 +621,10 @@ Windows 的設定與 Linux 或 macOS 略有不同(_範例以 Cline 為例_)5. 點擊 `Apply` 儲存變更。6. 同樣方式也可在 JetBrains Junie 的 `Settings` -> `Tools` -> `Junie` -> `MCP Settings` 新增 context7。</details>+<details><summary><b>在 Warp 安裝</b></summary>+詳情請參考 [Warp Model Context Protocol 文件](https://docs.warp.dev/knowledge-and-collaboration/mcp#adding-an-mcp-server)。1. 前往 `Settings` > `AI` > `Manage MCP servers`2. 點擊 `+ Add` 新增 MCP 伺服器@@ -568,10 +642,14 @@ Windows 的設定與 Linux 或 macOS 略有不同(_範例以 Cline 為例_)```4. 點擊 `Save` 套用變更。</details>+<details><summary><b>在 Opencode 安裝</b></summary>+將以下內容加入你的 Opencode 設定檔。更多資訊請參考 [Opencode MCP 文件](https://opencode.ai/docs/mcp-servers)。+#### Opencode 遠端伺服器連線+```json"mcp": {"context7": {@@ -581,7 +659,9 @@ Windows 的設定與 Linux 或 macOS 略有不同(_範例以 Cline 為例_)}}```+#### Opencode 本地伺服器連線+```json{"mcp": {@@ -594,8 +674,10 @@ Windows 的設定與 Linux 或 macOS 略有不同(_範例以 Cline 為例_)}```</details>+<details><summary><b>在 Kiro 安裝</b></summary>+詳情請參考 [Kiro Model Context Protocol 文件](https://kiro.dev/docs/mcp/configuration/)。1. 前往 `Kiro` > `MCP Servers`2. 點擊 `+ Add` 按鈕新增 MCP 伺服器。@@ -615,28 +697,38 @@ Windows 的設定與 Linux 或 macOS 略有不同(_範例以 Cline 為例_)```4. 點擊 `Save` 套用變更。</details>+<details><summary><b>在 OpenAI Codex 安裝</b></summary>+詳情請參考 [OpenAI Codex](https://github.com/openai/codex)。將下列設定加入你的 OpenAI Codex MCP 伺服器設定:+#### 本地伺服器連接+```toml[mcp_servers.context7]args = ["-y", "@upstash/context7-mcp"]command = "npx"```+#### 遠端伺服器連接+```toml[mcp_servers.context7]url = "https://mcp.context7.com/mcp"http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }```</details>+<details><summary><b>在 LM Studio 安裝</b></summary>+詳情請參考 [LM Studio MCP 支援](https://lmstudio.ai/blog/lmstudio-v0.3.17)。+#### 一鍵安裝:[](https://lmstudio.ai/install-mcp?name=context7&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkB1cHN0YXNoL2NvbnRleHQ3LW1jcCJdfQ%3D%3D)+#### 手動設定:1. 前往 `Program`(右側)> `Install` > `Edit mcp.json`2. 貼上以下設定:@@ -653,6 +745,7 @@ http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }3. 點擊 `Save` 套用變更。4. 可於右側 `Program` 下方或聊天框底部的插頭圖示切換 MCP 伺服器開關。</details>+## 🔨 可用工具Context7 MCP 提供下列工具供 LLM 使用:- `resolve-library-id`:將一般函式庫名稱解析為 Context7 相容的函式庫 ID。@@ -661,6 +754,7 @@ Context7 MCP 提供下列工具供 LLM 使用:- `query-docs`:根據 Context7 相容的函式庫 ID 取得文件。- `libraryId`(必填):Context7 相容的函式庫 ID(如 `/mongodb/docs`, `/vercel/next.js`)- `query`(必填):用於取得相關文件的問題或任務+## 💻 開發複製專案並安裝依賴:```bash@@ -672,6 +766,7 @@ pnpm run build```<details><summary><b>本地設定範例</b></summary>+```json{"mcpServers": {@@ -683,15 +778,19 @@ pnpm run build}```</details>+<details><summary><b>使用 MCP Inspector 測試</b></summary>+```bashnpx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp```</details>+## 🚨 疑難排解<details><summary><b>找不到模組錯誤</b></summary>+若遇到 `ERR_MODULE_NOT_FOUND`,請嘗試用 `bunx` 取代 `npx`:```json{@@ -705,8 +804,10 @@ npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp```這通常能解決 `npx` 無法正確安裝或解析套件的問題。</details>+<details><summary><b>ESM 解析問題</b></summary>+若出現 `Error: Cannot find module 'uriTemplate.js'`,請嘗試加上 `--experimental-vm-modules` 參數:```json{@@ -719,8 +820,10 @@ npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp}```</details>+<details><summary><b>TLS/憑證問題</b></summary>+可加上 `--experimental-fetch` 參數繞過 TLS 問題:```json{@@ -733,20 +836,25 @@ npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp}```</details>+<details><summary><b>一般 MCP 客戶端錯誤</b></summary>+1. 嘗試加上 `@latest` 於套件名稱2. 改用 `bunx` 取代 `npx`3. 或改用 `deno`4. 請確認 Node.js 版本為 v18 或以上,以支援原生 fetch</details>+## ⚠️ 免責聲明Context7 專案由社群貢獻,雖然我們致力於維持高品質,但無法保證所有函式庫文件的正確性、完整性或安全性。Context7 上的專案由各自擁有者開發與維護,非 Context7 官方。若發現可疑、不當或潛在有害內容,請於專案頁面點選「檢舉」按鈕通知我們。我們會嚴肅處理所有檢舉,並盡快審查標記內容,以維護平台的完整性與安全。使用 Context7 即表示你同意自行承擔風險。+## 🤝 與我們聯繫歡迎追蹤與加入社群:- 📢 追蹤我們的 [X](https://x.com/contextai) 以獲取最新消息- 🌐 造訪我們的 [官方網站](https://context7.com)- 💬 加入我們的 [Discord 社群](https://upstash.com/discord)+## 📺 Context7 媒體報導- [Better Stack:「免費工具讓 Cursor 智慧提升 10 倍」](https://youtu.be/52FC3qObp9E)- [Cole Medin:「這絕對是 AI 程式助理最強 MCP 伺服器」](https://www.youtube.com/watch?v=G7gK8H6u7Rs)@@ -756,7 +864,9 @@ Context7 專案由社群貢獻,雖然我們致力於維持高品質,但無- [Income Stream Surfers:「Context7:將改變 AI 程式開發的新 MCP 伺服器」](https://www.youtube.com/watch?v=PS-2Azb-C3M)- [AICodeKing:「Context7 + Cline & RooCode:這個 MCP 伺服器讓 CLINE 效率提升 100 倍!」](https://www.youtube.com/watch?v=qZfENAPMnyo)- [Sean Kochel:「5 個 MCP 伺服器讓你程式開發如虎添翼(即插即用)」](https://www.youtube.com/watch?v=LqTQi8qexJM)+## ⭐ 星標歷史[](https://www.star-history.com/#upstash/context7&Date)+## 📄 授權MIT