Context7 Platform -- Up-to-date docs for AI agents
new arch (#1283)
Enes Akar66ea0d6aad10
diff --git a/.changeset/some-suns-turn.md b/.changeset/some-suns-turn.mdnew file mode 100644index 00000000..a3db5cf0--- /dev/null+++ b/.changeset/some-suns-turn.md@@ -0,0 +1,27 @@+---+"@upstash/context7-mcp": major+---++Upgrade MCP server to v2.0.0 with intelligent query-based architecture++Breaking Changes++- Removed get-library-docs tool, replaced with new query-docs tool+- resolve-library-id now requires both query and libraryName parameters+- Removed mode, topic, page, and limit parameters from documentation fetching+- Renamed context7CompatibleLibraryID parameter to libraryId++New Features++- Intelligent reranked and deduplicated library selection based on user intent+- Smart snippet selection with relevance-based ranking for documentation retrieval+- Query-driven context fetching that understands what the user is trying to accomplish+- Added security warnings for sensitive data in query parameters+- Added tool call limits (max 3 calls per question) to prevent excessive context window usage++Improvements++- Simplified API key header extraction (removed redundant case variants)+- Removed unused actualPort variable and dead code+- Cleaner type definitions with new ContextRequest and ContextResponse types+- Better error messages for library search failures\ No newline at end of filediff --git a/README.md b/README.mdindex fc27e846..cd605ee2 100644--- a/README.md+++ b/README.md@@ -958,7 +958,7 @@ Add the following configuration to the `mcp` section of your Copilot Coding Agen"headers": {"CONTEXT7_API_KEY": "YOUR_API_KEY"},- "tools": ["get-library-docs", "resolve-library-id"]+ "tools": ["query-docs", "resolve-library-id"]}}}@@ -983,7 +983,7 @@ For more information, see the [official GitHub documentation](https://docs.githu"headers": {"CONTEXT7_API_KEY": "YOUR_API_KEY"},- "tools": ["get-library-docs", "resolve-library-id"]+ "tools": ["query-docs", "resolve-library-id"]}}}@@ -997,7 +997,7 @@ Or, for a local server:"context7": {"type": "local","command": "npx",- "tools": ["get-library-docs", "resolve-library-id"],+ "tools": ["query-docs", "resolve-library-id"],"args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]}}@@ -1135,7 +1135,7 @@ Open the "Settings" page of the app, navigate to "Plugins," and enter the follow}```-Once saved, enter in the chat `get-library-docs` followed by your Context7 documentation ID (e.g., `get-library-docs /nuxt/ui`). More information is available on [BoltAI's Documentation site](https://docs.boltai.com/docs/plugins/mcp-servers). For BoltAI on iOS, [see this guide](https://docs.boltai.com/docs/boltai-mobile/mcp-servers).+Once saved, enter in the chat `query-docs` followed by your Context7 documentation ID (e.g., `query-docs /nuxt/ui`). More information is available on [BoltAI's Documentation site](https://docs.boltai.com/docs/plugins/mcp-servers). For BoltAI on iOS, [see this guide](https://docs.boltai.com/docs/boltai-mobile/mcp-servers).</details>@@ -1312,12 +1312,12 @@ See the [Emdash repository](https://github.com/generalaction/emdash) for more inContext7 MCP provides the following tools that LLMs can use:- `resolve-library-id`: Resolves a general library name into a Context7-compatible library ID.+ - `query` (required): The user's question or task (used to rank results by relevance)- `libraryName` (required): The name of the library to search for-- `get-library-docs`: Fetches documentation for a library using a Context7-compatible library ID.- - `context7CompatibleLibraryID` (required): Exact Context7-compatible library ID (e.g., `/mongodb/docs`, `/vercel/next.js`)- - `topic` (optional): Focus the docs on a specific topic (e.g., "routing", "hooks")- - `page` (optional, default 1): Page number for pagination (1-10). If the context is not sufficient, try page=2, page=3, etc. with the same topic.+- `query-docs`: Retrieves documentation for a library using a Context7-compatible library ID.+ - `libraryId` (required): Exact Context7-compatible library ID (e.g., `/mongodb/docs`, `/vercel/next.js`)+ - `query` (required): The question or task to get relevant documentation for## 🛟 Tips@@ -1344,19 +1344,19 @@ If you are behind an HTTP proxy, Context7 uses the standard `https_proxy` / `HTTClone the project and install dependencies:```bash-bun i+pnpm i```Build:```bash-bun run build+pnpm run build```Run the server:```bash-bun run dist/index.js+node packages/mcp/dist/index.js```### CLI Arguments@@ -1370,13 +1370,13 @@ bun run dist/index.jsExample with HTTP transport and port 8080:```bash-bun run dist/index.js --transport http --port 8080+node packages/mcp/dist/index.js --transport http --port 8080```Another example with stdio transport:```bash-bun run dist/index.js --transport stdio --api-key YOUR_API_KEY+node packages/mcp/dist/index.js --transport stdio --api-key YOUR_API_KEY```### Environment Variablesdiff --git a/i18n/README.ar.md b/i18n/README.ar.mdindex 367bce7f..dc5fc230 100644--- a/i18n/README.ar.md+++ b/i18n/README.ar.md@@ -13,7 +13,6 @@## ✅ مع Context7يستخرج Context7 MCP التوثيق والأمثلة البرمجية المحدثة مباشرة من المصدر — ويضعها في طلبك للنموذج.-أضف `use context7` إلى طلبك في Cursor:```txt@@ -29,8 +28,7 @@- 1️⃣ اكتب طلبك بشكل طبيعي- 2️⃣ أخبر النموذج بـ `use context7`- 3️⃣ احصل على أكواد تعمل مباشرة--لا حاجة للتنقل بين التبويبات، لا واجهات برمجة تطبيقات وهمية، لا أكواد قديمة.+ لا حاجة للتنقل بين التبويبات، لا واجهات برمجة تطبيقات وهمية، لا أكواد قديمة.## 🛠️ البدء@@ -50,7 +48,6 @@ npx -y @smithery/cli install @upstash/context7-mcp --client claude### التثبيت في Cursorاذهب إلى: `Settings` -> `Cursor Settings` -> `MCP` -> `Add new global MCP server`-أو أضف هذا إلى ملف `~/.cursor/mcp.json`:```json@@ -173,7 +170,7 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp@latest"context7": {"type": "http","url": "https://mcp.context7.com/mcp",- "tools": ["get-library-docs", "resolve-library-id"]+ "tools": ["query-docs", "resolve-library-id"]}}}@@ -230,16 +227,17 @@ docker build -t context7-mcp .### الأدوات المتوفرة- `resolve-library-id`: يحول اسم مكتبة عام إلى معرف متوافق مع Context7.-- `get-library-docs`: يستخرج التوثيق حسب المعرف.- - `context7CompatibleLibraryID`: مطلوب- - `topic`: موضوع معين مثل "routing"- - `page` (اختياري، افتراضي 1): رقم الصفحة للترقيم (1-10). إذا كان السياق غير كافٍ، جرب page=2، page=3، إلخ مع نفس الموضوع.+ - `query` (مطلوب): سؤال أو مهمة المستخدم (لترتيب الصلة)+ - `libraryName` (مطلوب): اسم المكتبة للبحث عنها+- `query-docs`: يستخرج التوثيق حسب المعرف.+ - `libraryId` (مطلوب): معرف Context7 المتوافق الدقيق (مثل `/mongodb/docs`, `/vercel/next.js`)+ - `query` (مطلوب): السؤال أو المهمة للحصول على توثيق ذي صلة## التطوير```bash-bun i-bun run build+pnpm i+pnpm run build```**التهيئة المحلية:**diff --git a/i18n/README.de.md b/i18n/README.de.mdindex d0327e6b..a9681ebf 100644--- a/i18n/README.de.md+++ b/i18n/README.de.md@@ -13,7 +13,6 @@ KI-Sprachmodelle (LLMs) greifen auf veraltete oder allgemeine Informationen übe## ✅ Mit Context7Context7 MCP holt aktuelle, versionsspezifische Dokumentationen und Codebeispiele direkt aus der Quelle und fügt sie in deinen Prompt ein.-Füge `use context7` zu deinem Prompt in Cursor hinzu:```txt@@ -29,8 +28,7 @@ Context7 holt aktuelle Codebeispiele und Dokumentationen direkt in den Kontext d- 1️⃣ Schreibe deinen Prompt auf natürliche Weise- 2️⃣ Weise das LLM an, context7 zu verwenden, mit `use context7`- 3️⃣ Erhalte funktionierende Codeantworten--Kein Tab-Switching, keine halluzinierten APIs, die nicht existieren, keine veralteten Code-Generierungen.+ Kein Tab-Switching, keine halluzinierten APIs, die nicht existieren, keine veralteten Code-Generierungen.## 🛠️ Erste Schritte@@ -50,7 +48,6 @@ npx -y @smithery/cli install @upstash/context7-mcp --client claude### Installation in CursorGehe zu: `Einstellungen` -> `Cursor-Einstellungen` -> `MCP` -> `Neuen globalen MCP-Server hinzufügen`-Der empfohlene Ansatz ist die folgende Konfiguration in deine Cursor-Datei `~/.cursor/mcp.json` einzufügen. Siehe die [Cursor MCP Dokumentation](https://docs.cursor.com/context/model-context-protocol) für mehr Informationen.```json@@ -66,7 +63,6 @@ Der empfohlene Ansatz ist die folgende Konfiguration in deine Cursor-Datei `~/.c<details><summary>Alternative: Bun verwenden</summary>-```json{"mcpServers": {@@ -77,12 +73,9 @@ Der empfohlene Ansatz ist die folgende Konfiguration in deine Cursor-Datei `~/.c}}```-</details>-<details><summary>Alternative: Deno verwenden</summary>-```json{"mcpServers": {@@ -93,13 +86,9 @@ Der empfohlene Ansatz ist die folgende Konfiguration in deine Cursor-Datei `~/.c}}```-</details>-### Installation in Windsurf-Füge dies zu deiner Windsurf MCP-Konfigurationsdatei hinzu. Siehe die [Windsurf MCP Dokumentation](https://docs.windsurf.com/windsurf/mcp) für mehr Informationen.-```json{"mcpServers": {@@ -110,14 +99,10 @@ 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)-Füge dies zu deiner VS Code MCP-Konfigurationsdatei hinzu. Siehe die [VS Code MCP Dokumentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) für mehr Informationen.-```json{"servers": {@@ -129,11 +114,8 @@ Füge dies zu deiner VS Code MCP-Konfigurationsdatei hinzu. Siehe die [VS Code M}}```-### Installation in Zed-Es 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{"context_servers": {@@ -145,19 +127,13 @@ Es kann über [Zed Extensions](https://zed.dev/extensions?query=Context7) instal}}```-### Installation in Claude Code-Fü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 Desktop-Fü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{"mcpServers": {@@ -168,30 +144,23 @@ Füge dies zu deiner Claude Desktop `claude_desktop_config.json` Datei hinzu. Si}}```-### Installation im Copilot Coding Agent-Füge die folgende Konfiguration zum Abschnitt `mcp` deiner Copilot Coding Agent-Konfigurationsdatei hinzu (Repository->Settings->Copilot->Coding agent->MCP configuration):-```json{"mcpServers": {"context7": {"type": "http","url": "https://mcp.context7.com/mcp",- "tools": ["get-library-docs", "resolve-library-id"]+ "tools": ["query-docs", "resolve-library-id"]}}}```-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 CLI-1. Ö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:-```json{"mcpServers": {@@ -201,69 +170,49 @@ Weitere Informationen findest du in der [offiziellen GitHub-Dokumentation](https"headers": {"CONTEXT7_API_KEY": "YOUR_API_KEY"},- "tools": ["get-library-docs", "resolve-library-id"]+ "tools": ["query-docs", "resolve-library-id"]}}}```-Oder für einen lokalen Server:-```json{"mcpServers": {"context7": {"type": "local","command": "npx",- "tools": ["get-library-docs", "resolve-library-id"],+ "tools": ["query-docs", "resolve-library-id"],"args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]}}}```-Falls die `mcp-config.json`-Datei nicht existiert, erstelle sie.-### Docker verwenden-Wenn 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-alpine-WORKDIR /app-# Installiere die neueste Version globalRUN npm install -g @upstash/context7-mcp@latest-# Port freigeben, falls nötig (optional, abhängig von der MCP-Client-Interaktion)# EXPOSE 3000-# Standardbefehl zum Ausführen des ServersCMD ["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 .```-2. **Konfiguriere deinen MCP-Client:**-Aktualisiere die Konfiguration deines MCP-Clients, um den Docker-Befehl zu verwenden.-_Beispiel für eine cline_mcp_settings.json:_-```json{"mcpServers": {@@ -278,34 +227,24 @@ 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.- - `libraryName` (erforderlich)-- `get-library-docs`: Ruft die Dokumentation für eine Bibliothek mit einer Context7-kompatiblen Bibliotheks-ID ab.- - `context7CompatibleLibraryID` (erforderlich)- - `topic` (optional): Fokussiert die Dokumentation auf ein bestimmtes Thema (z.B. "routing", "hooks")- - `page` (optional, Standard 1): Seitennummer für die Paginierung (1-10). Wenn der Kontext nicht ausreicht, versuchen Sie page=2, page=3 usw. mit demselben Thema.-+ - `query` (erforderlich): Die Frage oder Aufgabe des Benutzers (zur Relevanzranking)+ - `libraryName` (erforderlich): Der Name der zu suchenden Bibliothek+- `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## Entwicklung-Klone das Projekt und installiere die Abhängigkeiten:-```bash-bun i+pnpm i```-Bauen:-```bash-bun run build+pnpm run build```-### Lokales Konfigurationsbeispiel-```json{"mcpServers": {@@ -316,19 +255,13 @@ bun run build}}```-### Testen mit MCP Inspector-```bashnpx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp@latest```-## Fehlerbehebung-### ERR_MODULE_NOT_FOUND-Wenn du diesen Fehler siehst, versuche `bunx` anstelle von `npx` zu verwenden.-```json{"mcpServers": {@@ -339,13 +272,9 @@ 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ösungsprobleme-Wenn du einen Fehler wie `Error: Cannot find module 'uriTemplate.js'` bekommst, versuche mit dem Flag `--experimental-vm-modules` auszuführen:-```json{"mcpServers": {@@ -356,34 +285,21 @@ Wenn du einen Fehler wie `Error: Cannot find module 'uriTemplate.js'` bekommst,}}```-### MCP-Client-Fehler-1. 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.-## Haftungsausschluss-Context7-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)- [Income stream surfers: "Context7 + SequentialThinking MCPs: Is This AGI?"](https://www.youtube.com/watch?v=-ggvzyLpK6o)- [Julian Goldie SEO: "Context7: New MCP AI Agent Update"](https://www.youtube.com/watch?v=CTZm6fBYisc)- [JeredBlu: "Context 7 MCP: Get Documentation Instantly + VS Code Setup"](https://www.youtube.com/watch?v=-ls0D-rtET4)- [Income stream surfers: "Context7: The New MCP Server That Will CHANGE AI Coding"](https://www.youtube.com/watch?v=PS-2Azb-C3M)-## Verlauf der Sterne-[](https://www.star-history.com/#upstash/context7&Date)-## Lizenz-MITdiff --git a/i18n/README.es.md b/i18n/README.es.mdindex 64aa3538..8af19437 100644--- a/i18n/README.es.md+++ b/i18n/README.es.md@@ -13,7 +13,6 @@ Los LLMs dependen de información desactualizada o genérica sobre las bibliotec## ✅ Con Context7El Context7 MCP obtiene documentación y ejemplos de código actualizados y específicos de la versión directamente desde la fuente, y los coloca directamente en tu prompt.-Añade `use context7` a tu prompt en Cursor:```txt@@ -29,8 +28,7 @@ Context7 obtiene ejemplos de código y documentación actualizados directamente- 1️⃣ Escribe tu prompt de forma natural- 2️⃣ Dile al LLM que `use context7`- 3️⃣ Obtén respuestas de código que funcionan--Sin cambiar de pestaña, sin APIs inventadas que no existen, sin generaciones de código desactualizadas.+ Sin cambiar de pestaña, sin APIs inventadas que no existen, sin generaciones de código desactualizadas.## 🛠️ Empezando@@ -50,7 +48,6 @@ npx -y @smithery/cli install @upstash/context7-mcp --client claude### Instalar en CursorVe a: `Settings` -> `Cursor Settings` -> `MCP` -> `Add new global MCP server`-Pegar la siguiente configuración en tu archivo `~/.cursor/mcp.json` de Cursor es el metodo recomendado. Consulta la [documentación de MCP de Cursor](https://docs.cursor.com/context/model-context-protocol) para más información.```json@@ -66,7 +63,6 @@ Pegar la siguiente configuración en tu archivo `~/.cursor/mcp.json` de Cursor e<details><summary>Alternativa: Usar Bun</summary>-```json{"mcpServers": {@@ -77,12 +73,9 @@ Pegar la siguiente configuración en tu archivo `~/.cursor/mcp.json` de Cursor e}}```-</details>-<details><summary>Alternativa: Usar Deno</summary>-```json{"mcpServers": {@@ -93,13 +86,9 @@ Pegar la siguiente configuración en tu archivo `~/.cursor/mcp.json` de Cursor e}}```-</details>-### Instalar en Windsurf-Añ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{"mcpServers": {@@ -110,14 +99,10 @@ 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)-Añade esto a tu archivo de configuración MCP de VS Code. Consulta la [documentación de VS Code MCP](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) para más información.-```json{"servers": {@@ -129,19 +114,13 @@ Añade esto a tu archivo de configuración MCP de VS Code. Consulta la [document}}```-### Instalar en Claude Code-Ejecuta 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 Desktop-Añ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{"mcpServers": {@@ -152,30 +131,23 @@ Añade esto a tu archivo `claude_desktop_config.json` de Claude Desktop. Consult}}```-### Instalar en Copilot Coding Agent-Agrega 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{"mcpServers": {"context7": {"type": "http","url": "https://mcp.context7.com/mcp",- "tools": ["get-library-docs", "resolve-library-id"]+ "tools": ["query-docs", "resolve-library-id"]}}}```-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 CLI-1. 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`:-```json{"mcpServers": {@@ -185,54 +157,42 @@ Para más información, consulta la [documentación oficial de GitHub](https://d"headers": {"CONTEXT7_API_KEY": "YOUR_API_KEY"},- "tools": ["get-library-docs", "resolve-library-id"]+ "tools": ["query-docs", "resolve-library-id"]}}}```-O, para un servidor local:-```json{"mcpServers": {"context7": {"type": "local","command": "npx",- "tools": ["get-library-docs", "resolve-library-id"],+ "tools": ["query-docs", "resolve-library-id"],"args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]}}}```-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.- - `libraryName` (requerido)-- `get-library-docs`: Obtiene documentación para una biblioteca utilizando un ID de biblioteca compatible con Context7.- - `context7CompatibleLibraryID` (requerido)- - `topic` (opcional): Enfoca la documentación en un tema específico (p. ej., "routing", "hooks")- - `page` (opcional, por defecto 1): Número de página para la paginación (1-10). Si el contexto no es suficiente, intente page=2, page=3, etc. con el mismo tema.-+ - `query` (requerido): La pregunta o tarea del usuario (para ranking de relevancia)+ - `libraryName` (requerido): El nombre de la biblioteca a buscar+- `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## Desarrollo-Clona el proyecto e instala las dependencias:-```bash-bun i+pnpm i```-Compila:-```bash-bun run build+pnpm run build```-### Ejemplo de Configuración Local-```json{"mcpServers": {@@ -243,19 +203,13 @@ bun run build}}```-### Probando con MCP Inspector-```bashnpx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp@latest```-## Solución de Problemas-### ERR_MODULE_NOT_FOUND-Si ves este error, intenta usar `bunx` en lugar de `npx`.-```json{"mcpServers": {@@ -266,30 +220,19 @@ 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 MCP-1. 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)- [Income stream surfers: "Context7 + SequentialThinking MCPs: Is This AGI?"](https://www.youtube.com/watch?v=-ggvzyLpK6o)- [Julian Goldie SEO: "Context7: New MCP AI Agent Update"](https://www.youtube.com/watch?v=CTZm6fBYisc)- [JeredBlu: "Context 7 MCP: Get Documentation Instantly + VS Code Setup"](https://www.youtube.com/watch?v=-ls0D-rtET4)- [Income stream surfers: "Context7: The New MCP Server That Will CHANGE AI Coding"](https://www.youtube.com/watch?v=PS-2Azb-C3M)-## Historial de Estrellas-[](https://www.star-history.com/#upstash/context7&Date)-## Licencia-MITdiff --git a/i18n/README.fr.md b/i18n/README.fr.mdindex 5c8c9a40..73477b6c 100644--- a/i18n/README.fr.md+++ b/i18n/README.fr.md@@ -13,7 +13,6 @@ Les LLMs s’appuient sur des informations obsolètes ou génériques concernant## ✅ Avec Context7Context7 MCP récupère la documentation et les exemples de code à jour, spécifiques à la version, directement à la source — et les place dans votre prompt.-Ajoutez `use context7` à votre prompt dans Cursor :```txt@@ -29,8 +28,7 @@ Context7 apporte des exemples de code et de la documentation à jour directement- 1️⃣ Rédigez votre prompt naturellement- 2️⃣ Dites au LLM `use context7`- 3️⃣ Obtenez des réponses de code qui fonctionnent--Plus besoin de changer d’onglet, plus d’APIs inventées, plus de code obsolète.+ Plus besoin de changer d’onglet, plus d’APIs inventées, plus de code obsolète.## 🛠️ Démarrage@@ -50,7 +48,6 @@ npx -y @smithery/cli install @upstash/context7-mcp --client claude### Installation dans CursorAllez dans : `Settings` -> `Cursor Settings` -> `MCP` -> `Add new global MCP server`-La méthode recommandée est de coller la configuration suivante dans votre fichier `~/.cursor/mcp.json`. Voir la [documentation Cursor MCP](https://docs.cursor.com/context/model-context-protocol) pour plus d’informations.```json@@ -66,7 +63,6 @@ La méthode recommandée est de coller la configuration suivante dans votre fich<details><summary>Alternative : Utiliser Bun</summary>-```json{"mcpServers": {@@ -77,12 +73,9 @@ La méthode recommandée est de coller la configuration suivante dans votre fich}}```-</details>-<details><summary>Alternative : Utiliser Deno</summary>-```json{"mcpServers": {@@ -93,13 +86,9 @@ La méthode recommandée est de coller la configuration suivante dans votre fich}}```-</details>-### Installation dans Windsurf-Ajoutez ceci à votre fichier de configuration MCP Windsurf. Voir la [documentation Windsurf MCP](https://docs.windsurf.com/windsurf/mcp) pour plus d’informations.-```json{"mcpServers": {@@ -110,14 +99,10 @@ 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)-Ajoutez ceci à votre fichier de configuration MCP VS Code. Voir la [documentation VS Code MCP](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) pour plus d'informations.-```json{"servers": {@@ -129,11 +114,8 @@ Ajoutez ceci à votre fichier de configuration MCP VS Code. Voir la [documentati}}```-### Installation dans Zed-Peut ê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{"context_servers": {@@ -145,19 +127,13 @@ Peut être installé via [Zed Extensions](https://zed.dev/extensions?query=Conte}}```-### Installation dans Claude Code-Exé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 Desktop-Ajoutez ceci à votre fichier `claude_desktop_config.json`. Voir la [documentation Claude Desktop MCP](https://modelcontextprotocol.io/quickstart/user).-```json{"mcpServers": {@@ -168,11 +144,8 @@ Ajoutez ceci à votre fichier `claude_desktop_config.json`. Voir la [documentati}}```-### Installation dans BoltAI-Ouvrez la page "Settings" de l'application, naviguez jusqu'à "Plugins", et entrez le JSON suivant :-```json{"mcpServers": {@@ -183,32 +156,24 @@ Ouvrez la page "Settings" de l'application, naviguez jusqu'à "Plugins", et entr}}```--Une fois enregistré, saisissez dans le chat `get-library-docs` suivi de votre ID de documentation Context7 (par exemple, `get-library-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).-+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 Agent-Ajoutez la configuration suivante à la section `mcp` de votre fichier de configuration Copilot Coding Agent (Repository->Settings->Copilot->Coding agent->MCP configuration) :-```json{"mcpServers": {"context7": {"type": "http","url": "https://mcp.context7.com/mcp",- "tools": ["get-library-docs", "resolve-library-id"]+ "tools": ["query-docs", "resolve-library-id"]}}}```-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 CLI-1. 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` :-```json{"mcpServers": {@@ -218,69 +183,49 @@ Pour plus d'informations, consultez la [documentation officielle GitHub](https:/"headers": {"CONTEXT7_API_KEY": "YOUR_API_KEY"},- "tools": ["get-library-docs", "resolve-library-id"]+ "tools": ["query-docs", "resolve-library-id"]}}}```-Ou, pour un serveur local :-```json{"mcpServers": {"context7": {"type": "local","command": "npx",- "tools": ["get-library-docs", "resolve-library-id"],+ "tools": ["query-docs", "resolve-library-id"],"args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]}}}```-Si le fichier `mcp-config.json` n'existe pas, créez-le.-### Utilisation avec Docker-Si 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-alpine-WORKDIR /app-# Installer la dernière version en globalRUN npm install -g @upstash/context7-mcp@latest-# Exposer le port par défaut si besoin (optionnel)# EXPOSE 3000-# Commande par défautCMD ["context7-mcp"]```-</details>-Puis, construisez l’image :-```bashdocker build -t context7-mcp .```-2. **Configurez votre client MCP :**-Mettez à jour la configuration de votre client MCP pour utiliser la commande Docker.-_Exemple pour un fichier cline_mcp_settings.json :_-```json{"mcpServers": {@@ -295,13 +240,9 @@ 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 Windows-La 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{"mcpServers": {@@ -314,32 +255,21 @@ 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)-- `get-library-docs` : Récupère la documentation d’une bibliothèque via un ID Context7.- - `context7CompatibleLibraryID` (obligatoire)- - `topic` (optionnel) : Focaliser la doc sur un sujet précis (ex : "routing", "hooks")- - `page` (optionnel, par défaut 1) : Numéro de page pour la pagination (1-10). Si le contexte n'est pas suffisant, essayez page=2, page=3, etc. avec le même sujet.-+- `query-docs` : Récupère la documentation d’une bibliothèque via un ID Context7.+ - `libraryId` (obligatoire)## Développement-Clonez le projet et installez les dépendances :-```bash-bun i+pnpm i```-Build :-```bash-bun run build+pnpm run build```-### Exemple de configuration locale-```json{"mcpServers": {@@ -350,19 +280,13 @@ bun run build}}```-### Tester avec MCP Inspector-```bashnpx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp@latest```-## Dépannage-### ERR_MODULE_NOT_FOUND-Si vous voyez cette erreur, essayez d’utiliser `bunx` à la place de `npx`.-```json{"mcpServers": {@@ -373,13 +297,9 @@ 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 ESM-Si vous rencontrez une erreur comme : `Error: Cannot find module 'uriTemplate.js'` essayez d'exécuter avec le drapeau `--experimental-vm-modules` :-```json{"mcpServers": {@@ -390,20 +310,14 @@ Si vous rencontrez une erreur comme : `Error: Cannot find module 'uriTemplate.js}}```-### Erreurs client MCP-1. 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)- [Income stream surfers: "Context7 + SequentialThinking MCPs: Is This AGI?"](https://www.youtube.com/watch?v=-ggvzyLpK6o)@@ -412,11 +326,7 @@ 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)-## Licence-MITdiff --git a/i18n/README.id-ID.md b/i18n/README.id-ID.mdindex 70d67fe6..3ff15cbd 100644--- a/i18n/README.id-ID.md+++ b/i18n/README.id-ID.md@@ -41,26 +41,24 @@ Kunjungi [panduan penambahan proyek](./adding-projects.md) untuk mempelajari car- Node.js >= v18.0.0- 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):+```bashnpx -y @smithery/cli@latest install @upstash/context7-mcp --client <NAMA_KLIEN> --key <KUNCI_SMITHERY_ANDA>```+Anda dapat menemukan kunci Smithery Anda di [halaman web Smithery.ai](https://smithery.ai/server/@upstash/context7-mcp).-</details>+</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{"mcpServers": {@@ -70,11 +68,8 @@ 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{"mcpServers": {@@ -85,7 +80,6 @@ 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)@@ -100,7 +94,6 @@ 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)@@ -116,13 +109,10 @@ 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": {@@ -132,9 +122,7 @@ Tambahkan ini ke file konfigurasi MCP Windsurf Anda. Lihat [dokumentasi MCP Wind}}```-#### Koneksi Server Lokal Windsurf-```json{"mcpServers": {@@ -145,16 +133,12 @@ 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": {@@ -164,9 +148,7 @@ Untuk detail lebih lanjut, kunjungi [dokumentasi Trae](https://docs.trae.ai/ide/}}```-#### Koneksi Server Lokal Trae-```json{"mcpServers": {@@ -177,18 +159,13 @@ 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": {@@ -199,9 +176,7 @@ Tambahkan ini ke file konfigurasi MCP VS Code Anda. Lihat [dokumentasi MCP VS Co}}```-#### Koneksi Server Lokal VS Code-```json"mcp": {"servers": {@@ -213,9 +188,7 @@ 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).@@ -248,7 +221,6 @@ 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.@@ -264,7 +236,6 @@ 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.@@ -292,25 +263,18 @@ 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 Remote Claude Code-```shclaude mcp add --transport http context7 https://mcp.context7.com/mcp```-#### Koneksi Server Lokal Claude Code-```shclaude mcp add context7 -- npx -y @upstash/context7-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.@@ -325,7 +289,6 @@ Tambahkan ini ke file `claude_desktop_config.json` Claude Desktop Anda. Lihat [d}```</details>-<details><summary><b>Instal di Cline</b>@@ -336,7 +299,6 @@ Anda dapat dengan mudah menginstal Context7 melalui [Pasar Server MCP Cline](htt3. 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:@@ -350,9 +312,8 @@ Buka halaman "Pengaturan" aplikasi, navigasikan ke "Plugin," dan masukkan JSON b}}```-Setelah disimpan, masukkan di obrolan `get-library-docs` diikuti oleh ID dokumentasi Context7 Anda (contoh: `get-library-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).+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:@@ -394,7 +355,6 @@ 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`.@@ -411,13 +371,10 @@ 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**.3. Navigasikan ke bagian **Alat**.@@ -429,16 +386,12 @@ Untuk mengonfigurasi Context7 MCP di Augment Code, Anda dapat menggunakan antarm6. Beri nama MCP: **Context7**.7. 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 Pengaturan3. Di bawah Lanjutan, klik Edit di settings.json4. Tambahkan konfigurasi server ke array `mcpServers` di objek `augment.advanced`-```json"augment.advanced": {"mcpServers": [@@ -450,17 +403,12 @@ 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": {@@ -471,9 +419,7 @@ Tambahkan ini ke file konfigurasi MCP Roo Code Anda. Lihat [dokumentasi MCP Roo}}```-#### Koneksi Server Lokal Roo Code-```json{"mcpServers": {@@ -484,9 +430,7 @@ 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:@@ -505,7 +449,6 @@ 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.@@ -520,7 +463,6 @@ 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.@@ -538,7 +480,6 @@ 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.@@ -559,7 +500,6 @@ 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.@@ -582,13 +522,10 @@ 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": {@@ -598,9 +535,7 @@ Tambahkan ini ke file konfigurasi Opencode Anda. Lihat [dokumentasi MCP Opencode}}```-#### Koneksi Server Lokal Opencode-```json{"mcp": {@@ -612,9 +547,7 @@ 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 Agent@@ -626,7 +559,7 @@ Tambahkan konfigurasi berikut ke bagian `mcp` file konfigurasi Copilot Coding Ag"type": "http","url": "https://mcp.context7.com/mcp","tools": [- "get-library-docs",+ "query-docs","resolve-library-id"]}@@ -635,13 +568,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{"mcpServers": {@@ -651,31 +581,26 @@ Untuk informasi lebih lanjut, lihat [dokumentasi resmi GitHub](https://docs.gith"headers": {"CONTEXT7_API_KEY": "YOUR_API_KEY"},- "tools": ["get-library-docs", "resolve-library-id"]+ "tools": ["query-docs", "resolve-library-id"]}}}```-Atau, untuk server lokal:-```json{"mcpServers": {"context7": {"type": "local","command": "npx",- "tools": ["get-library-docs", "resolve-library-id"],+ "tools": ["query-docs", "resolve-library-id"],"args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]}}}```-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.@@ -700,43 +625,31 @@ 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:-```json{"mcpServers": {@@ -747,26 +660,19 @@ Lihat [Dukungan MCP LM Studio](https://lmstudio.ai/blog/lmstudio-v0.3.17) untuk}}```-3. 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 Tersedia-Context7 MCP menyediakan alat berikut yang dapat digunakan oleh LLM:-- `resolve-library-id`: Mengubah nama pustaka umum menjadi ID pustaka yang kompatibel dengan Context7.+ - `query` (wajib): Pertanyaan atau tugas pengguna (untuk peringkat relevansi)- `libraryName` (wajib): Nama pustaka yang ingin dicari-- `get-library-docs`: Mengambil dokumentasi untuk pustaka menggunakan ID pustaka yang kompatibel dengan Context7.- - `context7CompatibleLibraryID` (wajib): ID pustaka yang kompatibel dengan Context7 (contoh: `/mongodb/docs`, `/vercel/next.js`)- - `topic` (opsional): Fokuskan dokumen pada topik tertentu (contoh: "routing", "hooks")- - `page` (opsional, default 1): Nomor halaman untuk pagination (1-10). Jika konteksnya tidak cukup, coba page=2, page=3, dll. dengan topik yang sama.-+- `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:>> ```toml@@ -776,9 +682,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.>> ```txt@@ -786,39 +690,27 @@ Context7 MCP menyediakan alat berikut yang dapat digunakan oleh LLM:> ```>> Sintaks garis miring memberi tahu alat MCP pustaka mana yang harus dimuat dokumennya.-## 💻 Pengembangan-Salin proyek dan instal dependensi:-```bash-bun i+pnpm i```-Bangun:-```bash-bun run build+pnpm run build```-Jalankan server:-```bash-bun run dist/index.js+node packages/mcp/dist/index.js```-### Argumen CLI-`context7-mcp` menerima bendera CLI berikut:-- `--transport <stdio|http>` – Transportasi yang digunakan (`stdio` secara default).- `--port <number>` – Port yang didengarkan saat menggunakan transport `http` (default `3000`).Contoh dengan transport http dan port 8080:-```bash-bun run dist/index.js --transport http --port 8080+node packages/mcp/dist/index.js --transport http --port 8080```-<details><summary><b>Contoh Konfigurasi Lokal</b></summary>```json@@ -832,16 +724,13 @@ bun run 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`:@@ -857,7 +746,6 @@ 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`:@@ -872,7 +760,6 @@ 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:@@ -887,7 +774,6 @@ 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 paket@@ -895,21 +781,14 @@ Gunakan bendera `--experimental-fetch` untuk melewati masalah terkait TLS:3. Pertimbangkan menggunakan `deno` sebagai alternatif lain4. Pastikan Anda menggunakan Node.js v18 atau lebih tinggi untuk dukungan fetch native</details>-## ⚠️ Penafian-Proyek 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 Kami-Tetap 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)- [Income Stream Surfers: "Context7 + SequentialThinking MCPs: Is This AGI?"](https://www.youtube.com/watch?v=-ggvzyLpK6o)@@ -918,11 +797,7 @@ 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)-## 📄 Lisensi-MITdiff --git a/i18n/README.it.md b/i18n/README.it.mdindex 33fb631b..97baa0cb 100644--- a/i18n/README.it.md+++ b/i18n/README.it.md@@ -1,7 +1,6 @@# Context7 MCP - Documentazione aggiornata per qualsiasi prompt[](https://context7.com) [](https://smithery.ai/server/@upstash/context7-mcp) [<img alt="Install in VS Code (npx)" src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Installa%20Context7%20MCP&color=0098FF">](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%7B%22name%22%3A%22context7%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40upstash%2Fcontext7-mcp%40latest%22%5D%7D)-[](./README.zh-CN.md) [](./README.ko.md) [](./README.es.md) [](./README.fr.md) [-purple>)](./README.pt-BR.md) [](./README.it.md)## ❌ Senza Context7@@ -15,7 +14,6 @@ LLMs si affidano a informazioni obsolete o generiche sulle librerie che utilizzi## ✅ Con Context7Context7 MCP recupera documentazione aggiornata, specifica per versione e esempi di codice direttamente dalla fonte — e li inserisce direttamente nel tuo prompt.-Aggiungi `use context7` al prompt in Cursor:```txt@@ -31,8 +29,7 @@ Context7 recupera esempi di codice e documentazione aggiornati direttamente nel- 1️⃣ Scrivi il tuo prompt in modo naturale- 2️⃣ Indica all'LLM di usare context7- 3️⃣ Ottieni risposte di codice funzionante--Nessun cambio di tab, nessuna API allucinata che non esiste, nessuna generazione di codice obsoleta.+ Nessun cambio di tab, nessuna API allucinata che non esiste, nessuna generazione di codice obsoleta.## 🛠️ Iniziare@@ -52,7 +49,6 @@ npx -y @smithery/cli install @upstash/context7-mcp --client claude### Installare in CursorVai a: `Impostazioni` -> `Impostazioni cursore` -> `MCP` -> `Aggiungi nuovo server MCP globale`-Incollare la seguente configurazione nel file `~/.cursor/mcp.json` di Cursor è l'approccio consigliato. Vedi [Cursor MCP docs](https://docs.cursor.com/context/model-context-protocol) per ulteriori informazioni.```json@@ -68,7 +64,6 @@ Incollare la seguente configurazione nel file `~/.cursor/mcp.json` di Cursor è<details><summary>Alternativa: Usa Bun</summary>-```json{"mcpServers": {@@ -79,12 +74,9 @@ Incollare la seguente configurazione nel file `~/.cursor/mcp.json` di Cursor è}}```-</details>-<details><summary>Alternativa: Usa Deno</summary>-```json{"mcpServers": {@@ -95,13 +87,9 @@ Incollare la seguente configurazione nel file `~/.cursor/mcp.json` di Cursor è}}```-</details>-### Installare in Windsurf-Aggiungi questo al tuo file di configurazione Windsurf MCP. Vedi [Windsurf MCP docs](https://docs.windsurf.com/windsurf/mcp) per ulteriori informazioni.-```json{"mcpServers": {@@ -112,14 +100,10 @@ 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)-Aggiungi questo al tuo file di configurazione MCP di VS Code. Vedi [VS Code MCP docs](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) per ulteriori informazioni.-```json{"servers": {@@ -131,11 +115,8 @@ Aggiungi questo al tuo file di configurazione MCP di VS Code. Vedi [VS Code MCP}}```-### Installare in Zed-Può essere installato tramite [Zed Extensions](https://zed.dev/extensions?query=Context7) oppure puoi aggiungere questo al tuo `settings.json` di Zed. Vedi [Zed Context Server docs](https://zed.dev/docs/assistant/context-servers) per ulteriori informazioni.-```json{"context_servers": {@@ -147,19 +128,13 @@ Può essere installato tramite [Zed Extensions](https://zed.dev/extensions?query}}```-### Installare in Claude Code-Esegui 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 Desktop-Aggiungi questo al tuo file `claude_desktop_config.json` di Claude Desktop. Vedi [Claude Desktop MCP docs](https://modelcontextprotocol.io/quickstart/user) per ulteriori informazioni.-```json{"mcpServers": {@@ -170,30 +145,23 @@ Aggiungi questo al tuo file `claude_desktop_config.json` di Claude Desktop. Vedi}}```-### Installazione in Copilot Coding Agent-Aggiungi la seguente configurazione alla sezione `mcp` del file di configurazione di Copilot Coding Agent (Repository->Settings->Copilot->Coding agent->MCP configuration):-```json{"mcpServers": {"context7": {"type": "http","url": "https://mcp.context7.com/mcp",- "tools": ["get-library-docs", "resolve-library-id"]+ "tools": ["query-docs", "resolve-library-id"]}}}```-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 CLI-1. Apri il file di configurazione MCP di Copilot CLI. La posizione è `~/.copilot/mcp-config.json` (dove `~` è la tua home directory).2. Aggiungi quanto segue all'oggetto `mcpServers` nel tuo file `mcp-config.json`:-```json{"mcpServers": {@@ -203,69 +171,49 @@ Per maggiori informazioni, consulta la [documentazione ufficiale GitHub](https:/"headers": {"CONTEXT7_API_KEY": "YOUR_API_KEY"},- "tools": ["get-library-docs", "resolve-library-id"]+ "tools": ["query-docs", "resolve-library-id"]}}}```-Oppure, per un server locale:-```json{"mcpServers": {"context7": {"type": "local","command": "npx",- "tools": ["get-library-docs", "resolve-library-id"],+ "tools": ["query-docs", "resolve-library-id"],"args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]}}}```-Se il file `mcp-config.json` non esiste, crealo.-### Utilizzo di Docker-Se preferisci eseguire il server MCP in un contenitore Docker:-1. **Costruisci l'immagine Docker:**-Prima, crea un `Dockerfile` nella radice del progetto (o ovunque tu preferisca):-<details><summary>Clicca per visualizzare il contenuto del Dockerfile</summary>-```DockerfileFROM node:18-alpine-WORKDIR /app-# Installa l ultima versione globalmenteRUN npm install -g @upstash/context7-mcp@latest-# Esponi la porta predefinita se necessario (opzionale, dipende dall interazione del client MCP)# EXPOSE 3000-# Comando predefinito per eseguire il serverCMD ["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 .```-2. **Configura il tuo client MCP:**-Aggiorna la configurazione del tuo client MCP per utilizzare il comando Docker.-_Esempio per un file cline_mcp_settings.json:_-```json{"mcpServers": {@@ -280,34 +228,24 @@ 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.-- `libraryName` (obbligatorio)-- `get-library-docs`: Recupera la documentazione per una libreria utilizzando un ID di libreria compatibile con Context7.-- `context7CompatibleLibraryID` (obbligatorio)-- `topic` (opzionale): Concentra la documentazione su un argomento specifico (es., "routing", "hooks")-- `page` (opzionale, predefinito 1): Numero di pagina per la paginazione (1-10). Se il contesto non è sufficiente, prova page=2, page=3, ecc. con lo stesso argomento.-+ - `query` (obbligatorio): La domanda o il compito dell'utente (per il ranking di rilevanza)+ - `libraryName` (obbligatorio): Il nome della libreria da cercare+- `query-docs`: Recupera la documentazione per una libreria utilizzando un ID di libreria compatibile con Context7.+ - `libraryId` (obbligatorio): ID esatto compatibile con Context7 (ad esempio, `/mongodb/docs`, `/vercel/next.js`)+ - `query` (obbligatorio): La domanda o il compito per ottenere documentazione pertinente## Sviluppo-Clona il progetto e installa le dipendenze:-```bash-bun i+pnpm i```-Compila:-```bash-bun run build+pnpm run build```-### Esempio di Configurazione Locale-```json{"mcpServers": {@@ -318,19 +256,13 @@ bun run build}}```-### Test con MCP Inspector-```bashnpx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp@latest```-## Risoluzione dei problemi-### ERR_MODULE_NOT_FOUND-Se vedi questo errore, prova a usare `bunx` invece di `npx`.-```json{"mcpServers": {@@ -341,13 +273,9 @@ 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 ESM-Se riscontri un errore come: `Error: Cannot find module 'uriTemplate.js'` prova a eseguire con il flag `--experimental-vm-modules`:-```json{"mcpServers": {@@ -358,34 +286,21 @@ Se riscontri un errore come: `Error: Cannot find module 'uriTemplate.js'` prova}}```-### Errori del Client MCP-1. Prova a rimuovere `@latest` dal nome del pacchetto.-2. Prova a usare `bunx` come alternativa.-3. Prova a usare `deno` come alternativa.-4. Assicurati di utilizzare Node v18 o superiore per avere il supporto nativo di fetch con `npx`.-## Dichiarazione di non responsabilità-I progetti Context7 sono contributi della comunità e, sebbene ci impegniamo a mantenere un'alta qualità, non possiamo garantire l'accuratezza, la completezza o la sicurezza di tutta la documentazione delle librerie. I progetti elencati in Context7 sono sviluppati e gestiti dai rispettivi proprietari, non da Context7. Se riscontri contenuti sospetti, inappropriati o potenzialmente dannosi, utilizza il pulsante "Segnala" sulla pagina del progetto per informarci immediatamente. Prendiamo sul serio tutte le segnalazioni e esamineremo prontamente i contenuti segnalati per mantenere l'integrità e la sicurezza della nostra piattaforma. Utilizzando Context7, riconosci di farlo a tua discrezione e a tuo rischio.-## Context7 nei Media-- [Better Stack: "Free Tool Makes Cursor 10x Smarter"](https://youtu.be/52FC3qObp9E)- [Cole Medin: "This is Hands Down the BEST MCP Server for AI Coding Assistants"](https://www.youtube.com/watch?v=G7gK8H6u7Rs)- [Income stream surfers: "Context7 + SequentialThinking MCPs: Is This AGI?"](https://www.youtube.com/watch?v=-ggvzyLpK6o)- [Julian Goldie SEO: "Context7: New MCP AI Agent Update"](https://www.youtube.com/watch?v=CTZm6fBYisc)- [JeredBlu: "Context 7 MCP: Get Documentation Instantly + VS Code Setup"](https://www.youtube.com/watch?v=-ls0D-rtET4)- [Income stream surfers: "Context7: The New MCP Server That Will CHANGE AI Coding"](https://www.youtube.com/watch?v=PS-2Azb-C3M)-## Storico delle Stelle-[](https://www.star-history.com/#upstash/context7&Date)-## Licenza-MITdiff --git a/i18n/README.ja.md b/i18n/README.ja.mdindex 762f5802..c626d387 100644--- a/i18n/README.ja.md+++ b/i18n/README.ja.md@@ -1,7 +1,6 @@# Context7 MCP - どんなプロンプトにも最新のコードドキュメントで応える[](https://context7.com) [](https://smithery.ai/server/@upstash/context7-mcp) [<img alt="Install in VS Code (npx)" src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20Context7%20MCP&color=0098FF">](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%7B%22name%22%3A%22context7%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40upstash%2Fcontext7-mcp%40latest%22%5D%7D)-[](./README.zh-TW.md) [](./README.zh-CN.md) [](./README.ja.md) [](./README.ko.md) [](./README.es.md) [](./README.fr.md) [-purple>)](./README.pt-BR.md) [](./README.it.md) [](./README.id-ID.md) [](./README.de.md) [](./README.ru.md) [](./README.tr.md) [](./README.ar.md)## ❌ Context7 を使わないと@@ -15,7 +14,6 @@ LLM は使用しているライブラリに関する古い情報や一般的な## ✅ Context7 を使うとContext7 MCP は最新のバージョン固有のドキュメントとコード例をソースから直接取得し、プロンプトに直接配置します。-Cursor のプロンプトに `use context7` を追加するだけ:```txt@@ -31,8 +29,7 @@ Context7 は最新のコード例とドキュメントを直接 LLM のコンテ- 1️⃣ 普段通りにプロンプトを書く- 2️⃣ LLM に `use context7` と指示する- 3️⃣ 動作するコードの回答を得る--タブの切り替えも、存在しない API のハルシネーションも、古いコード生成もありません。+ タブの切り替えも、存在しない API のハルシネーションも、古いコード生成もありません。## 📚 プロジェクトの追加@@ -44,10 +41,8 @@ Context7 は最新のコード例とドキュメントを直接 LLM のコンテ- Node.js >= v18.0.0- Cursor、Windsurf、Claude Desktop またはその他の MCP クライアント-<details><summary><b>Smithery 経由でのインストール</b></summary>-[Smithery](https://smithery.ai/server/@upstash/context7-mcp) 経由で任意のクライアントに Context7 MCP サーバーを自動的にインストールするには:```bash@@ -57,20 +52,13 @@ 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{"mcpServers": {@@ -80,11 +68,8 @@ Smithery キーは [Smithery.ai Web ページ](https://smithery.ai/server/@upsta}}```-#### Cursor ローカルサーバー接続-[](https://cursor.com/install-mcp?name=context7&config=eyJjb21tYW5kIjoibnB4IC15IEB1cHN0YXNoL2NvbnRleHQ3LW1jcCJ9)-```json{"mcpServers": {@@ -95,12 +80,9 @@ 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{"mcpServers": {@@ -111,14 +93,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{"mcpServers": {@@ -134,18 +112,12 @@ 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": {@@ -155,9 +127,7 @@ Smithery キーは [Smithery.ai Web ページ](https://smithery.ai/server/@upsta}}```-#### Windsurf ローカルサーバー接続-```json{"mcpServers": {@@ -168,19 +138,13 @@ 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": {@@ -191,9 +155,7 @@ Smithery キーは [Smithery.ai Web ページ](https://smithery.ai/server/@upsta}}```-#### VS Code ローカルサーバー接続-```json"mcp": {"servers": {@@ -205,20 +167,16 @@ Smithery キーは [Smithery.ai Web ページ](https://smithery.ai/server/@upsta}}```-</details>-<details><summary><b>Cline でのインストール</b></summary>-1. **Cline** を開きます。2. メニューアイコン (☰) をクリックし、**MCP サーバー**セクションに移動します。3. **リモートサーバー** タブを選択します。4. **設定を編集** ボタンをクリックします。5. context7 に関連する設定を `mcpServers` に追加します:-```json{"mcpServers": {@@ -232,15 +190,11 @@ 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{"mcp": {@@ -253,9 +207,7 @@ Smithery キーは [Smithery.ai Web ページ](https://smithery.ai/server/@upsta}}```-または、ローカルサーバーの場合:-```json{"mcp": {@@ -269,16 +221,11 @@ 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{"context_servers": {@@ -290,33 +237,22 @@ 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 --transport http context7 https://mcp.context7.com/mcp```-#### Claude Code ローカルサーバー接続-```shclaude mcp add context7 -- npx -y @upstash/context7-mcp```-</details>-<details><summary><b>Claude Desktop へのインストール</b></summary>-これを Claude Desktop の `claude_desktop_config.json` ファイルに追加します。詳細は [Claude Desktop MCP ドキュメント](https://modelcontextprotocol.io/quickstart/user) を参照してください。-```json{"mcpServers": {@@ -327,14 +263,10 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp}}```-</details>-<details><summary><b>BoltAI へのインストール</b></summary>-アプリの "Settings" ページを開き、"Plugins" に移動し、以下の JSON を入力します:-```json{"mcpServers": {@@ -345,38 +277,28 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp}}```--保存後、チャットで `get-library-docs` の後に Context7 ドキュメント ID を入力します(例:`get-library-docs /nuxt/ui`)。詳細情報は [BoltAI ドキュメンテーションサイト](https://docs.boltai.com/docs/plugins/mcp-servers) で利用可能です。iOS 版 BoltAI については、[このガイドを参照してください](https://docs.boltai.com/docs/boltai-mobile/mcp-servers)。-+保存後、チャットで `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{"mcpServers": {"context7": {"type": "http","url": "https://mcp.context7.com/mcp",- "tools": ["get-library-docs", "resolve-library-id"]+ "tools": ["query-docs", "resolve-library-id"]}}}```-詳細は [公式 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{"mcpServers": {@@ -386,72 +308,51 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp"headers": {"CONTEXT7_API_KEY": "YOUR_API_KEY"},- "tools": ["get-library-docs", "resolve-library-id"]+ "tools": ["query-docs", "resolve-library-id"]}}}```-または、ローカルサーバーの場合:-```json{"mcpServers": {"context7": {"type": "local","command": "npx",- "tools": ["get-library-docs", "resolve-library-id"],+ "tools": ["query-docs", "resolve-library-id"],"args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]}}}```-`mcp-config.json` ファイルが存在しない場合は、作成してください。-</details>-<details><summary><b>Docker を使用</b></summary>-MCP サーバーを Docker コンテナで実行したい場合:-1. **Docker イメージのビルド:**-まず、プロジェクトルート(または希望の場所)に `Dockerfile` を作成します:-<details><summary>Dockerfile の内容を表示</summary>-```DockerfileFROM node:18-alpine-WORKDIR /app-# 最新バージョンをグローバルにインストールRUN npm install -g @upstash/context7-mcp-# 必要に応じてデフォルトポートを公開(任意、MCP クライアントの相互作用に依存)# EXPOSE 3000-# サーバーを実行するデフォルトコマンドCMD ["context7-mcp"]```-</details>-次に、タグ(例:`context7-mcp`)を使用してイメージをビルドします。**Docker Desktop(または Docker デーモン)が実行中であることを確認してください。** `Dockerfile` を保存した同じディレクトリで次のコマンドを実行します:-```bashdocker build -t context7-mcp .```-2. **MCP クライアントの設定:**-MCP クライアントの設定を更新して Docker コマンドを使用するようにします。-_cline_mcp_settings.json の例:_-```json{"mcpServers": {@@ -466,16 +367,11 @@ 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{"mcpServers": {@@ -488,40 +384,28 @@ Windows での設定は Linux や macOS と比べて少し異なります(_例}}```-</details>-<details><summary><b>Augment Code へのインストール</b></summary>-Augment Code で Context7 MCP を設定するには、グラフィカルインターフェースまたは手動設定のいずれかを使用できます。-### **A. Augment Code UI を使用する場合**-1. ハンバーガーメニューをクリックします。2. **Settings** を選択します。3. **Tools** セクションに移動します。4. **+ Add MCP** ボタンをクリックします。5. 以下のコマンドを入力します:-```npx -y @upstash/context7-mcp@latest```-6. MCP に **Context7** と名前を付けます。7. **Add** ボタンをクリックします。-MCP サーバーが追加されたら、Augment Code 内で Context7 の最新コードドキュメンテーション機能を直接使用できます。-----### **B. 手動設定**-1. Cmd/Ctrl Shift P を押すか、Augment パネルのハンバーガーメニューに移動します2. Edit Settings を選択します3. Advanced の下で、Edit in settings.json をクリックします4. `augment.advanced` オブジェクト内の `mcpServers` 配列にサーバー設定を追加します-"augment.advanced": {"mcpServers": [{@@ -531,18 +415,12 @@ 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": {@@ -553,9 +431,7 @@ MCP サーバーが追加されたら、エディタを再起動します。エ}}```-#### Roo Code ローカルサーバー接続-```json{"mcpServers": {@@ -566,35 +442,25 @@ MCP サーバーが追加されたら、エディタを再起動します。エ}}```-</details>-<details><summary><b>Zencoder へのインストール</b></summary>-Zencoder で Context7 MCP を設定するには、以下の手順に従います:-1. Zencoder メニュー (...) に移動します2. ドロップダウンメニューから Agent tools を選択します3. Add custom MCP をクリックします4. 以下から名前とサーバー設定を追加し、Install ボタンを必ず押してください-```json{"command": "npx","args": ["-y", "@upstash/context7-mcp@latest"]}```-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{"mcpServers": {@@ -605,57 +471,38 @@ MCP サーバーが追加されたら、簡単に使用を続けることがで}}```-</details>-## 🔨 利用可能なツール-Context7 MCP は LLM が使用できる以下のツールを提供します:-- `resolve-library-id`:一般的なライブラリ名を Context7 互換のライブラリ ID に変換します。+ - `query`(必須):ユーザーの質問またはタスク(関連性によるランキングに使用)- `libraryName`(必須):検索するライブラリの名前--- `get-library-docs`:Context7 互換のライブラリ ID を使用してライブラリのドキュメントを取得します。- - `context7CompatibleLibraryID`(必須):正確な Context7 互換のライブラリ ID(例:`/mongodb/docs`、`/vercel/next.js`)- - `topic`(任意):ドキュメントの特定のトピックに焦点を当てます(例:"routing"、"hooks")- - `page`(任意、デフォルト 1):ページネーションのページ番号(1-10)。コンテキストが不十分な場合は、同じトピックでpage=2、page=3などを試してください。-+- `query-docs`:Context7 互換のライブラリ ID を使用してライブラリのドキュメントを取得します。+ - `libraryId`(必須):正確な Context7 互換のライブラリ ID(例:`/mongodb/docs`、`/vercel/next.js`)+ - `query`(必須):関連するドキュメントを取得するための質問またはタスク## 💻 開発-プロジェクトをクローンして依存関係をインストールします:-```bash-bun i+pnpm i```-ビルド:-```bash-bun run build+pnpm run build```-サーバーを実行:-```bash-bun run dist/index.js+node packages/mcp/dist/index.js```-### CLI 引数-`context7-mcp` は以下の CLI フラグを受け付けます:-- `--transport <stdio|http>` – 使用するトランスポート(デフォルトは `stdio`)。- `--port <number>` – `http` トランスポート使用時にリッスンするポート(デフォルト `3000`)。-http トランスポートとポート 8080 の例:-```bash-bun run dist/index.js --transport http --port 8080+node packages/mcp/dist/index.js --transport http --port 8080```-<details><summary><b>ローカル設定例</b></summary>-```json{"mcpServers": {@@ -666,25 +513,17 @@ bun run 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{"mcpServers": {@@ -695,16 +534,11 @@ 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{"mcpServers": {@@ -715,14 +549,10 @@ npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp}}```-</details>-<details><summary><b>TLS/証明書の問題</b></summary>-TLS 関連の問題を回避するには、`--experimental-fetch` フラグを使用します:-```json{"mcpServers": {@@ -733,33 +563,22 @@ 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)- [Income Stream Surfers: "Context7 + SequentialThinking MCPs: Is This AGI?"](https://www.youtube.com/watch?v=-ggvzyLpK6o)@@ -768,11 +587,7 @@ 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.ko.md b/i18n/README.ko.mdindex 59cb07d1..87e6195f 100644--- a/i18n/README.ko.md+++ b/i18n/README.ko.md@@ -1,7 +1,6 @@# Context7 MCP - 모든 프롬프트를 위한 최신 코드 문서[](https://context7.com) [](https://smithery.ai/server/@upstash/context7-mcp) [<img alt="Install in VS Code (npx)" src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20Context7%20MCP&color=0098FF">](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%7B%22name%22%3A%22context7%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40upstash%2Fcontext7-mcp%40latest%22%5D%7D)-[](./README.zh-TW.md) [](./README.zh-CN.md) [](./README.ja.md) [](./README.ko.md) [](./README.es.md) [](./README.fr.md) [-purple>)](./README.pt-BR.md) [](./README.it.md) [](./README.id-ID.md) [](./README.de.md) [](./README.ru.md) [](./README.tr.md) [](./README.ar.md)## ❌ Context7 없이@@ -15,7 +14,6 @@ LLM은 사용하는 라이브러리에 대한 오래되거나 일반적인 정## ✅ Context7 사용 시Context7 MCP는 최신 버전별 문서와 코드 예제를 소스에서 직접 가져와 프롬프트에 즉시 적용합니다.-Cursor에서 프롬프트에 `use context7`을 추가하세요:```txt@@ -31,8 +29,7 @@ Context7은 최신 코드 예제와 문서를 LLM의 컨텍스트에 즉시 가- 1️⃣ 평소처럼 자연스럽게 프롬프트 작성- 2️⃣ `use context7` 키워드 추가- 3️⃣ 실제 동작하는 코드 답변 받기--탭 전환도, 존재하지 않는 API도, 오래된 코드 생성도 없습니다.+ 탭 전환도, 존재하지 않는 API도, 오래된 코드 생성도 없습니다.## 📚 프로젝트 추가하기@@ -44,10 +41,8 @@ Context7에 여러분이 좋아하는 라이브러리를 추가(또는 업데이- Node.js >= v18.0.0- Cursor, Windsurf, Claude Desktop 또는 다른 MCP 클라이언트-<details><summary><b>Smithery를 통한 설치</b></summary>-[Smithery](https://smithery.ai/server/@upstash/context7-mcp)를 통해 모든 클라이언트에 Context7 MCP 서버를 자동으로 설치하려면:```bash@@ -57,20 +52,13 @@ 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 1.0부터는 아래 설치 버튼으로 한 번에 설치할 수 있습니다.-#### Cursor 원격 서버 연결-[](https://cursor.com/install-mcp?name=context7&config=eyJ1cmwiOiJodHRwczovL21jcC5jb250ZXh0Ny5jb20vbWNwIn0%3D)-```json{"mcpServers": {@@ -80,11 +68,8 @@ Smithery 키는 [Smithery.ai 웹페이지](https://smithery.ai/server/@upstash/c}}```-#### Cursor 로컬 서버 연결-[](https://cursor.com/install-mcp?name=context7&config=eyJjb21tYW5kIjoibnB4IC15IEB1cHN0YXNoL2NvbnRleHQ3LW1jcCJ9)-```json{"mcpServers": {@@ -95,12 +80,9 @@ Smithery 키는 [Smithery.ai 웹페이지](https://smithery.ai/server/@upstash/c}}```-<details><summary>대안: Bun 사용</summary>-[](https://cursor.com/install-mcp?name=context7&config=eyJjb21tYW5kIjoiYnVueCAteSBAdXBzdGFzaC9jb250ZXh0Ny1tY3AifQ%3D%3D)-```json{"mcpServers": {@@ -111,14 +93,10 @@ Smithery 키는 [Smithery.ai 웹페이지](https://smithery.ai/server/@upstash/c}}```-</details>-<details><summary>대안: Deno 사용</summary>-[](https://cursor.com/install-mcp?name=context7&config=eyJjb21tYW5kIjoiZGVubyBydW4gLS1hbGxvdy1lbnYgLS1hbGxvdy1uZXQgbnBtOkB1cHN0YXNoL2NvbnRleHQ3LW1jcCJ9)-```json{"mcpServers": {@@ -134,18 +112,12 @@ Smithery 키는 [Smithery.ai 웹페이지](https://smithery.ai/server/@upstash/c}}```-</details>-</details>-<details><summary><b>Windsurf에 설치</b></summary>-Windsurf MCP 설정 파일에 다음을 추가하세요. 자세한 내용은 [Windsurf MCP 문서](https://docs.windsurf.com/windsurf/mcp)를 참조하세요.-#### Windsurf 원격 서버 연결-```json{"mcpServers": {@@ -155,9 +127,7 @@ Windsurf MCP 설정 파일에 다음을 추가하세요. 자세한 내용은 [Wi}}```-#### Windsurf 로컬 서버 연결-```json{"mcpServers": {@@ -168,17 +138,12 @@ Windsurf MCP 설정 파일에 다음을 추가하세요. 자세한 내용은 [Wi}}```-</details>-<details><summary><b>Trae에 설치</b></summary>-수동 추가 기능을 사용하여 해당 MCP 서버의 JSON 설정 정보를 입력하세요.자세한 내용은 [Trae 문서](https://docs.trae.ai/ide/model-context-protocol?_lang=en)를 참조하세요.-#### Trae 원격 서버 연결-```json{"mcpServers": {@@ -188,9 +153,7 @@ Windsurf MCP 설정 파일에 다음을 추가하세요. 자세한 내용은 [Wi}}```-#### Trae 로컬 서버 연결-```json{"mcpServers": {@@ -201,19 +164,13 @@ Windsurf MCP 설정 파일에 다음을 추가하세요. 자세한 내용은 [Wi}}```-</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": {@@ -224,9 +181,7 @@ VS Code MCP 설정 파일에 다음을 추가하세요. 자세한 내용은 [VS}}```-#### VS Code 로컬 서버 연결-```json"mcp": {"servers": {@@ -238,16 +193,11 @@ VS Code MCP 설정 파일에 다음을 추가하세요. 자세한 내용은 [VS}}```-</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{"mcp": {@@ -260,9 +210,7 @@ Visual Studio MCP 설정 파일에 다음을 추가하세요(자세한 내용은}}```-또는 로컬 서버의 경우:-```json{"mcp": {@@ -276,16 +224,11 @@ Visual Studio MCP 설정 파일에 다음을 추가하세요(자세한 내용은}}```-자세한 정보 및 문제 해결은 [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 컨텍스트 서버 문서](https://zed.dev/docs/assistant/context-servers)를 참조하세요.-```json{"context_servers": {@@ -297,17 +240,12 @@ Visual Studio MCP 설정 파일에 다음을 추가하세요(자세한 내용은}}```-</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` 객체에 다음을 추가합니다:-```json{"mcpServers": {@@ -317,9 +255,7 @@ Visual Studio MCP 설정 파일에 다음을 추가하세요(자세한 내용은}}```-또는 로컬 서버의 경우:-```json{"mcpServers": {@@ -330,35 +266,23 @@ Visual Studio MCP 설정 파일에 다음을 추가하세요(자세한 내용은}}```-`mcpServers` 객체가 없으면 새로 만드세요.-</details>-<details><summary><b>Claude Code에 설치</b></summary>-이 명령을 실행하세요. 자세한 내용은 [Claude Code MCP 문서](https://docs.anthropic.com/ko/docs/claude-code/mcp)를 참조하세요.-#### Claude Code 원격 서버 연결-```shclaude mcp add --transport http context7 https://mcp.context7.com/mcp```-#### Claude Code 로컬 서버 연결-```shclaude mcp add context7 -- npx -y @upstash/context7-mcp```-</details>-<details><summary><b>Claude Desktop에 설치</b></summary>-Claude Desktop의 `claude_desktop_config.json` 파일에 다음을 추가하세요. 자세한 내용은 [Claude Desktop MCP 문서](https://modelcontextprotocol.io/quickstart/user)를 참조하세요.-```json{"mcpServers": {@@ -369,28 +293,20 @@ Claude Desktop의 `claude_desktop_config.json` 파일에 다음을 추가하세}}```-</details>-<details><summary><b>Cline에 설치</b></summary>-다음 지침에 따라 [Cline MCP 서버 마켓플레이스](https://cline.bot/mcp-marketplace)를 통해 Context7을 쉽게 설치할 수 있습니다:-1. **Cline**을 엽니다.2. 햄버거 메뉴 아이콘(☰)을 클릭하여 **MCP 서버** 섹션으로 들어갑니다.3. **마켓플레이스** 탭 내의 검색창을 사용하여 *Context7*을 찾습니다.4. **설치** 버튼을 클릭합니다.-</details>-<details><summary><b>BoltAI에 설치</b></summary>-앱의 "설정" 페이지를 열고 "플러그인"으로 이동한 후 다음 JSON을 입력합니다:-```json{"mcpServers": {@@ -401,38 +317,28 @@ Claude Desktop의 `claude_desktop_config.json` 파일에 다음을 추가하세}}```--저장되면 채팅에 `get-library-docs`를 입력한 다음 Context7 문서 ID(예: `get-library-docs /nuxt/ui`)를 입력합니다. 자세한 정보는 [BoltAI 문서 사이트](https://docs.boltai.com/docs/plugins/mcp-servers)에서 확인할 수 있습니다. iOS용 BoltAI의 경우 [이 가이드](https://docs.boltai.com/docs/boltai-mobile/mcp-servers)를 참조하세요.-+저장되면 채팅에 `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{"mcpServers": {"context7": {"type": "http","url": "https://mcp.context7.com/mcp",- "tools": ["get-library-docs", "resolve-library-id"]+ "tools": ["query-docs", "resolve-library-id"]}}}```-자세한 내용은 [공식 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{"mcpServers": {@@ -442,72 +348,51 @@ Claude Desktop의 `claude_desktop_config.json` 파일에 다음을 추가하세"headers": {"CONTEXT7_API_KEY": "YOUR_API_KEY"},- "tools": ["get-library-docs", "resolve-library-id"]+ "tools": ["query-docs", "resolve-library-id"]}}}```-또는 로컬 서버의 경우:-```json{"mcpServers": {"context7": {"type": "local","command": "npx",- "tools": ["get-library-docs", "resolve-library-id"],+ "tools": ["query-docs", "resolve-library-id"],"args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]}}}```-`mcp-config.json` 파일이 없으면 생성하세요.-</details>-<details><summary><b>Docker 사용하기</b></summary>-MCP 서버를 Docker 컨테이너에서 실행하려면:-1. **Docker 이미지 빌드:**-먼저 프로젝트 루트(또는 원하는 위치)에 `Dockerfile`을 만듭니다:-<details><summary>Dockerfile 내용 보기</summary>-```DockerfileFROM node:18-alpine-WORKDIR /app-# 최신 버전 전역 설치RUN npm install -g @upstash/context7-mcp-# 필요한 경우 기본 포트 노출 (선택 사항, MCP 클라이언트 상호 작용에 따라 다름)# EXPOSE 3000-# 서버 실행 기본 명령어CMD ["context7-mcp"]```-</details>-그런 다음 태그(예: `context7-mcp`)를 사용하여 이미지를 빌드합니다. **Docker Desktop (또는 Docker 데몬)이 실행 중인지 확인하세요.** `Dockerfile`을 저장한 디렉토리에서 다음 명령을 실행합니다:-```bashdocker build -t context7-mcp .```-2. **MCP 클라이언트 설정:**-MCP 클라이언트 설정을 업데이트하여 Docker 명령을 사용하도록 합니다.-_cline_mcp_settings.json 예시:_-```json{"mcpServers": {@@ -522,16 +407,11 @@ 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{"mcpServers": {@@ -544,40 +424,28 @@ Windows에서의 설정은 Linux나 macOS와 약간 다릅니다 (_예시에서}}```-</details>-<details><summary><b>Augment Code에 설치</b></summary>-Augment Code에서 Context7 MCP를 설정하려면 그래픽 인터페이스 또는 수동 설정을 사용할 수 있습니다.-### **A. Augment Code UI 사용**-1. 햄버거 메뉴를 클릭합니다.2. **설정**을 선택합니다.3. **도구** 섹션으로 이동합니다.4. **+ MCP 추가** 버튼을 클릭합니다.5. 다음 명령을 입력합니다:-```npx -y @upstash/context7-mcp@latest```-6. MCP 이름을 **Context7**으로 지정합니다.7. **추가** 버튼을 클릭합니다.-MCP 서버가 추가되면 Augment Code 내에서 직접 Context7의 최신 코드 문서 기능을 사용할 수 있습니다.-----### **B. 수동 설정**-1. Cmd/Ctrl Shift P를 누르거나 Augment 패널의 햄버거 메뉴로 이동합니다.2. 설정 편집을 선택합니다.3. 고급 아래에서 settings.json에서 편집을 클릭합니다.4. `augment.advanced` 객체의 `mcpServers` 배열에 서버 설정을 추가합니다.-"augment.advanced": {"mcpServers": [{@@ -587,18 +455,12 @@ 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": {@@ -609,9 +471,7 @@ Roo Code MCP 설정 파일에 다음을 추가하세요. 자세한 내용은 [Ro}}```-#### Roo Code 로컬 서버 연결-```json{"mcpServers": {@@ -622,35 +482,25 @@ Roo Code MCP 설정 파일에 다음을 추가하세요. 자세한 내용은 [Ro}}```-</details>-<details><summary><b>Zencoder에 설치</b></summary>-Zencoder에서 Context7 MCP를 설정하려면 다음 단계를 따르세요:-1. Zencoder 메뉴(...)로 이동합니다.2. 드롭다운 메뉴에서 에이전트 도구를 선택합니다.3. 사용자 지정 MCP 추가를 클릭합니다.4. 아래에서 이름과 서버 설정을 추가하고 설치 버튼을 누릅니다.-```json{"command": "npx","args": ["-y", "@upstash/context7-mcp@latest"]}```-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{"mcpServers": {@@ -661,19 +511,14 @@ Amazon Q Developer CLI 설정 파일에 다음을 추가하세요. 자세한 내}}```-</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. 더 많은 도구 연결을 클릭합니다.3. - 새 MCP 추가를 클릭합니다.4. 다음 설정을 추가합니다:-```json{"mcpServers": {@@ -683,19 +528,14 @@ Amazon Q Developer CLI 설정 파일에 다음을 추가하세요. 자세한 내}}```-</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. `+ 추가`를 클릭합니다.3. 대화 상자 왼쪽 상단의 `Command`를 클릭하고 목록에서 JSON으로 옵션을 선택합니다.4. 이 설정을 추가하고 `OK`를 클릭합니다.-```json{"mcpServers": {@@ -706,20 +546,14 @@ Amazon Q Developer CLI 설정 파일에 다음을 추가하세요. 자세한 내}}```-5. `Apply`를 클릭하여 변경 사항을 저장합니다.-</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 서버를 추가합니다.3. 아래 주어진 설정을 붙여넣습니다:-```json{"Context7": {@@ -731,18 +565,12 @@ Amazon Q Developer CLI 설정 파일에 다음을 추가하세요. 자세한 내}}```-4. `Save`를 클릭하여 변경 사항을 적용합니다.-</details>-<details><summary><b>Opencode에 설치</b></summary>-Opencode 설정 파일에 다음을 추가하세요. 자세한 내용은 [Opencode MCP 문서](https://opencode.ai/docs/mcp-servers)를 참조하세요.-#### Opencode 원격 서버 연결-```json"mcp": {"context7": {@@ -752,9 +580,7 @@ Opencode 설정 파일에 다음을 추가하세요. 자세한 내용은 [Openco}}```-#### Opencode 로컬 서버 연결-```json{"mcp": {@@ -766,18 +592,13 @@ Opencode 설정 파일에 다음을 추가하세요. 자세한 내용은 [Openco}}```-</details><details>-<summary><b>Kiro에 설치</b></summary>-자세한 내용은 [Kiro 모델 컨텍스트 프로토콜 문서](https://kiro.dev/docs/mcp/configuration/)를 참조하세요.-1. `Kiro` > `MCP Servers`로 이동합니다.2. `+ Add` 버튼을 클릭하여 새 MCP 서버를 추가합니다.3. 아래에 주어진 설정을 붙여넣습니다:-```json{"mcpServers": {@@ -791,51 +612,35 @@ Opencode 설정 파일에 다음을 추가하세요. 자세한 내용은 [Openco}}```-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>-## 🔨 사용 가능한 도구-Context7 MCP는 LLM이 사용할 수 있는 다음 도구들을 제공합니다:-- `resolve-library-id`: 일반적인 라이브러리 이름을 Context7이 인식할 수 있는 라이브러리 ID로 변환합니다.+ - `query` (필수): 사용자의 질문 또는 작업 (관련성 순위에 사용)- `libraryName` (필수): 검색할 라이브러리의 이름--- `get-library-docs`: Context7이 인식하는 라이브러리 ID를 사용하여 해당 라이브러리의 문서를 가져옵니다.- - `context7CompatibleLibraryID` (필수): 정확한 Context7 호환 라이브러리 ID (예: `/mongodb/docs`, `/vercel/next.js`)- - `topic` (선택): 특정 주제에 대한 문서에 집중합니다 (예: "routing", "hooks")- - `page` (선택, 기본값 1): 페이지네이션을 위한 페이지 번호 (1-10). 컨텍스트가 충분하지 않으면 동일한 주제로 page=2, page=3 등을 시도하세요.-+- `query-docs`: Context7이 인식하는 라이브러리 ID를 사용하여 해당 라이브러리의 문서를 가져옵니다.+ - `libraryId` (필수): 정확한 Context7 호환 라이브러리 ID (예: `/mongodb/docs`, `/vercel/next.js`)+ - `query` (필수): 관련 문서를 가져오기 위한 질문 또는 작업## 🛟 팁-### 규칙 추가-> 모든 프롬프트에 `use context7`을 추가하고 싶지 않다면, Windsurf의 `.windsurfrules` 파일이나 Cursor의 `Cursor Settings > Rules` 섹션(또는 사용 중인 MCP 클라이언트의 해당 기능)에서 간단한 규칙을 정의하여 코드 관련 질문에 Context7을 자동으로 호출할 수 있습니다:>> ```toml@@ -845,9 +650,7 @@ Context7 MCP는 LLM이 사용할 수 있는 다음 도구들을 제공합니다:> ```>> 그러면 추가 입력 없이도 관련 대화에서 Context7의 문서를 얻을 수 있습니다. match 부분에 여러분의 사용 사례를 추가할 수 있습니다.-### 라이브러리 ID 사용-> 사용하려는 라이브러리를 이미 정확히 알고 있다면, 프롬프트에 해당 라이브러리의 Context7 ID를 추가하세요. 이렇게 하면 Context7 MCP 서버가 라이브러리 매칭 단계를 건너뛰고 바로 문서 검색을 진행할 수 있습니다.>> ```txt@@ -855,43 +658,29 @@ Context7 MCP는 LLM이 사용할 수 있는 다음 도구들을 제공합니다:> ```>> 슬래시 구문은 MCP 도구에게 어떤 라이브러리의 문서를 로드할지 정확히 알려줍니다.-## 💻 개발-프로젝트를 복제하고 의존성을 설치하세요:-```bash-bun i+pnpm i```-빌드:-```bash-bun run build+pnpm run build```-서버 실행:-```bash-bun run dist/index.js+node packages/mcp/dist/index.js```-### CLI 인수-`context7-mcp`는 다음 CLI 플래그를 지원합니다:-- `--transport <stdio|http>` – 사용할 전송 방식 (`stdio`가 기본값).- `--port <number>` – `http` 전송 방식 사용 시 수신 대기할 포트 (기본값 `3000`).-http 전송과 포트 8080을 사용하는 예시:-```bash-bun run dist/index.js --transport http --port 8080+node packages/mcp/dist/index.js --transport http --port 8080```-<details><summary><b>로컬 설정 예시</b></summary>-```json{"mcpServers": {@@ -902,25 +691,17 @@ bun run 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 Errors</b></summary>-`ERR_MODULE_NOT_FOUND` 오류가 발생하면 `npx` 대신 `bunx`를 사용해 보세요:-```json{"mcpServers": {@@ -931,16 +712,11 @@ npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp}}```-이 방법은 `npx`가 패키지를 제대로 설치하거나 확인하지 못하는 환경에서 모듈 확인 문제를 해결하는 경우가 많습니다.-</details>-<details><summary><b>ESM Resolution 문제</b></summary>-`Error: Cannot find module 'uriTemplate.js'`와 같은 오류의 경우 `--experimental-vm-modules` 플래그를 사용해 보세요:-```json{"mcpServers": {@@ -951,14 +727,10 @@ npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp}}```-</details>-<details><summary><b>TLS/인증서 문제</b></summary>-`--experimental-fetch` 플래그를 사용하여 TLS 관련 문제를 우회하세요:-```json{"mcpServers": {@@ -969,33 +741,22 @@ npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp}}```-</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)에서 저희를 팔로우하고 최신 소식과 업데이트를 받아보세요.- 🌐 저희 [웹사이트](https://context7.com)를 방문하세요.- 💬 저희 [디스코드 커뮤니티](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)- [Income Stream Surfers: "Context7 + SequentialThinking MCPs: Is This AGI?"](https://www.youtube.com/watch?v=-ggvzyLpK6o)@@ -1004,11 +765,7 @@ 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)-## ⭐ Star History-[](https://www.star-history.com/#upstash/context7&Date)-## 라이선스-MITdiff --git a/i18n/README.pt-BR.md b/i18n/README.pt-BR.mdindex 094d4d9d..e8be9ef2 100644--- a/i18n/README.pt-BR.md+++ b/i18n/README.pt-BR.md@@ -1,9 +1,7 @@# Context7 MCP - Documentação de Código Atualizada para Qualquer Prompt[](https://context7.com) [](https://smithery.ai/server/@upstash/context7-mcp)-[<img alt="Instalar no Cursor" src="https://img.shields.io/badge/Instalar%20no%20CURSOR-000000?style=for-the-badge&logo=cursor&logoColor=white">](https://cursor.com/en/install-mcp?name=context7&config=eyJ1cmwiOiJodHRwczovL21jcC5jb250ZXh0Ny5jb20vbWNwIn0%3D) [<img alt="Instalar no VS Code (npx)" src="https://img.shields.io/badge/Instalar%20no%20VS%20Code-0098FF?style=for-the-badge&logo=visualstudiocode&logoColor=white">](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)-[](../README.md) [](./README.zh-TW.md) [](./README.zh-CN.md) [](./README.ja.md) [](./README.ko.md) [](./README.es.md) [](./README.fr.md) [](./README.it.md) [](./README.id-ID.md) [](./README.de.md) [](./README.ru.md) [](./README.uk.md) [](./README.tr.md) [](./README.ar.md) [](./README.vi.md)## ❌ Sem o Context7@@ -17,7 +15,6 @@ Os LLMs dependem de informações desatualizadas ou genéricas sobre as bibliote## ✅ Com o Context7O Context7 MCP extrai documentação e exemplos de código atualizados e específicos para cada versão diretamente da fonte — e os coloca diretamente em seu prompt.-Adicione `use context7` ao seu prompt no Cursor:```txt@@ -33,8 +30,7 @@ O Context7 busca exemplos de código e documentação atualizados diretamente pa- 1️⃣ Escreva seu prompt naturalmente- 2️⃣ Diga ao LLM `use context7`- 3️⃣ Obtenha respostas com código funcional--Sem alternar entre abas, sem APIs alucinadas que não existem, sem gerações de código desatualizadas.+ Sem alternar entre abas, sem APIs alucinadas que não existem, sem gerações de código desatualizadas.## 📚 Adicionando Projetos@@ -46,10 +42,8 @@ Confira nosso [guia de adição de projetos](./adding-projects.md) para aprender- Node.js >= v18.0.0- 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@@ -59,20 +53,13 @@ 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{"mcpServers": {@@ -82,11 +69,8 @@ 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{"mcpServers": {@@ -97,35 +81,23 @@ 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 Remota do Servidor Claude Code-```shclaude mcp add --transport http context7 https://mcp.context7.com/mcp```-#### Conexão Local do Servidor Claude Code-```shclaude mcp add context7 -- npx -y @upstash/context7-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": {@@ -135,9 +107,7 @@ Adicione isto ao arquivo de configuração MCP do Windsurf. Veja mais em [Windsu}}```-#### Conexão Local do Servidor Windsurf-```json{"mcpServers": {@@ -148,19 +118,13 @@ 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": {@@ -171,9 +135,7 @@ 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": {@@ -185,28 +147,20 @@ 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{"context_servers": {@@ -218,45 +172,28 @@ 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**.-3. Navegue até a seção **Tools**.-4. Clique no botão **+ Add MCP**.-5. Insira o seguinte comando:-```npx -y @upstash/context7-mcp@latest```-6. Nomeie o MCP: **Context7**.-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 Settings3. Em Advanced, clique em Edit em settings.json4. Adicione a configuração do servidor ao array `mcpServers` no objeto `augment.advanced`-```json"augment.advanced": {"mcpServers": [@@ -268,18 +205,12 @@ 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": {@@ -290,9 +221,7 @@ 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": {@@ -303,17 +232,12 @@ 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`:-```json{"mcpServers": {@@ -323,9 +247,7 @@ Veja os detalhes em [Configuração do Gemini CLI](https://google-gemini.github.}}```-Ou, para um servidor local:-```json{"mcpServers": {@@ -336,22 +258,14 @@ 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 Remota-Abra 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 Local-Abra 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{"mcpServers": {@@ -362,16 +276,11 @@ 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": {@@ -381,9 +290,7 @@ Adicione isto ao arquivo de configuração do Opencode. Veja mais em [Opencode M}}```-#### Conexão Local do Opencode-```json{"mcp": {@@ -395,43 +302,31 @@ 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`.3. Clique em `Command` no canto superior esquerdo do diálogo e selecione a opção As JSON na lista4. Adicione esta configuração e clique em `OK`-```json{"mcpServers": {@@ -442,22 +337,15 @@ Veja mais detalhes na [Documentação do JetBrains AI Assistant](https://www.jet}}```-5. 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`.3. Cole a configuração abaixo:-```json{"mcpServers": {@@ -471,19 +359,13 @@ 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": {@@ -493,9 +375,7 @@ Para mais detalhes, visite a [documentação do Trae](https://docs.trae.ai/ide/m}}```-#### Conexão Local do Servidor Trae-```json{"mcpServers": {@@ -506,16 +386,11 @@ 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": {@@ -526,9 +401,7 @@ Use estas alternativas para executar o servidor Context7 MCP local com outros ru}}```-#### Deno-```json{"mcpServers": {@@ -544,50 +417,32 @@ 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-alpine-WORKDIR /app-# Instalar a versão mais recente globalmenteRUN npm install -g @upstash/context7-mcp-# Expor porta padrão se necessário (opcional, depende da interação do cliente MCP)# EXPOSE 3000-# Comando padrão para rodar o servidorCMD ["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 .```-2. **Configure seu Cliente MCP:**-Atualize a configuração do seu cliente MCP para usar o comando Docker.-_Exemplo para um cline_mcp_settings.json:_-```json{"mcpServers": {@@ -602,23 +457,15 @@ 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{"mcpServers": {@@ -631,14 +478,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{"mcpServers": {@@ -649,18 +492,13 @@ 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`.3. Cole a configuração abaixo:-```json{"Context7": {@@ -672,41 +510,29 @@ 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 Agent-Adicione 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{"mcpServers": {"context7": {"type": "http","url": "https://mcp.context7.com/mcp",- "tools": ["get-library-docs", "resolve-library-id"]+ "tools": ["query-docs", "resolve-library-id"]}}}```-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{"mcpServers": {@@ -716,45 +542,34 @@ Para mais informações, veja a [documentação oficial do GitHub](https://docs."headers": {"CONTEXT7_API_KEY": "YOUR_API_KEY"},- "tools": ["get-library-docs", "resolve-library-id"]+ "tools": ["query-docs", "resolve-library-id"]}}}```-Ou, para um servidor local:-```json{"mcpServers": {"context7": {"type": "local","command": "npx",- "tools": ["get-library-docs", "resolve-library-id"],+ "tools": ["query-docs", "resolve-library-id"],"args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]}}}```-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:-```json{"mcpServers": {@@ -765,19 +580,13 @@ Veja mais em [Suporte a MCP no LM Studio](https://lmstudio.ai/blog/lmstudio-v0.3}}```-3. 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{"mcp": {@@ -790,9 +599,7 @@ Adicione isto ao arquivo de configuração MCP do Visual Studio (veja os [docs d}}```-Ou, para um servidor local:-```json{"mcp": {@@ -806,18 +613,12 @@ 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",@@ -829,9 +630,7 @@ 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",@@ -844,14 +643,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{"mcpServers": {@@ -862,24 +657,16 @@ Abra a página "Settings" do app, navegue até "Plugins" e insira o seguinte JSO}}```--Depois de salvar, digite no chat `get-library-docs` seguido do seu Context7 documentation ID (por exemplo, `get-library-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).-+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": {@@ -889,9 +676,7 @@ Configuração de exemplo -}}```-#### Conexão Local-```json{"mcpServers": {@@ -902,42 +687,30 @@ 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 tools3. Clique em Add custom MCP4. Adicione o nome e a configuração do servidor abaixo e certifique-se de clicar no botão Install-```json{"command": "npx","args": ["-y", "@upstash/context7-mcp"]}```-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": {@@ -948,9 +721,7 @@ Veja mais em [docs do Qodo Gen](https://docs.qodo.ai/qodo-documentation/qodo-gen}}```-#### Conexão Remota do Qodo Gen-```json{"mcpServers": {@@ -960,21 +731,16 @@ 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`.3. Clique em `Add Connector`.4. Selecione `Advanced`.5. Insira Server Name: `Context7`6. Cole o seguinte JSON na área de texto:-```json{"args": ["-y", "@upstash/context7-mcp"],@@ -982,27 +748,18 @@ Veja mais em [Local and Remote MCPs for Perplexity](https://www.perplexity.ai/he"env": {}}```-7. Clique em `Save`.-</details>-## 🔨 Ferramentas Disponíveis-O 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.+ - `query` (obrigatório): A pergunta ou tarefa do usuário (para ranking de relevância)- `libraryName` (obrigatório): O nome da biblioteca a ser pesquisada--- `get-library-docs`: Busca documentação para uma biblioteca usando um ID compatível com o Context7.- - `context7CompatibleLibraryID` (obrigatório): ID exato compatível com Context7 (por exemplo, `/mongodb/docs`, `/vercel/next.js`)- - `topic` (opcional): Focar os docs em um tópico específico (por exemplo, "routing", "hooks")- - `page` (opcional, padrão 1): Número da página para paginação (1-10). Se o contexto não for suficiente, tente page=2, page=3, etc. com o mesmo tópico.-+- `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:>> ```toml@@ -1012,9 +769,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.>> ```txt@@ -1022,49 +777,33 @@ O Context7 MCP fornece as seguintes ferramentas que LLMs podem usar:> ```>> A sintaxe com barra informa à ferramenta MCP exatamente qual biblioteca carregar.-## 💻 Desenvolvimento-Clone o projeto e instale as dependências:-```bash-bun i+pnpm i```-Build:-```bash-bun run build+pnpm run build```-Execute o servidor:-```bash-bun run dist/index.js+node 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.- `--port <number>` – Porta para escutar ao usar o transporte `http` (padrão `3000`).-Exemplo com transporte http e porta 8080:-```bash-bun run dist/index.js --transport http --port 8080+node packages/mcp/dist/index.js --transport http --port 8080```-Outro exemplo com transporte stdio:-```bash-bun run dist/index.js --transport stdio+node packages/mcp/dist/index.js --transport stdio```-<details><summary><b>Exemplo de Configuração Local</b></summary>-```json{"mcpServers": {@@ -1075,25 +814,17 @@ bun run 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{"mcpServers": {@@ -1104,16 +835,11 @@ 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{"mcpServers": {@@ -1124,14 +850,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{"mcpServers": {@@ -1142,33 +864,22 @@ 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>-## ⚠️ Aviso-Os 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 Conosco-Mantenha-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)- [Income Stream Surfers: "Context7 + SequentialThinking MCPs: Is This AGI?"](https://www.youtube.com/watch?v=-ggvzyLpK6o)@@ -1177,11 +888,7 @@ 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ça-MITdiff --git a/i18n/README.ru.md b/i18n/README.ru.mdindex a0d68e29..b136e324 100644--- a/i18n/README.ru.md+++ b/i18n/README.ru.md@@ -13,7 +13,6 @@ LLMs полагаются на устаревшую или обобщённую## ✅ С Context7Context7 MCP получает актуальную документацию и примеры кода, строго соответствующие нужной версии, прямо из исходных источников и вставляет их прямо в ваш промпт.-Добавьте строку `use context7` в промпт для Cursor:```txt@@ -29,8 +28,7 @@ Context7 MCP подгружает свежие примеры кода и док- 1️⃣ Напишите свой промпт так, как писали его всегда- 2️⃣ Добавьте к промпту `use context7`- 3️⃣ Получите работающий результат--Никакого переключения между вкладками, выдуманного API или устаревшего кода.+ Никакого переключения между вкладками, выдуманного API или устаревшего кода.## 🛠️ Начало работы@@ -50,7 +48,6 @@ npx -y @smithery/cli install @upstash/context7-mcp --client claude### Установка в CursorПерейдите в вкладку: `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) для получения дополнительной информации.```json@@ -66,7 +63,6 @@ npx -y @smithery/cli install @upstash/context7-mcp --client claude<details><summary>Альтернативный вариант - Bun</summary>-```json{"mcpServers": {@@ -77,12 +73,9 @@ npx -y @smithery/cli install @upstash/context7-mcp --client claude}}```-</details>-<details><summary>Альтернативный вариант - Deno</summary>-```json{"mcpServers": {@@ -93,13 +86,9 @@ npx -y @smithery/cli install @upstash/context7-mcp --client claude}}```-</details>-### Установка в Windsurf-Добавьте следующие строки в ваш конфигурационный файл Windsurf MCP. Смотрите [документацию Windsurf MCP](https://docs.windsurf.com/windsurf/mcp) для получения дополнительной информации.-```json{"mcpServers": {@@ -110,14 +99,10 @@ 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)-Добавьте следующие строки в ваш конфигурационный файл VS Code MCP. Смотрите [документацию VS Code MCP](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) для получения дополнительной информации.-```json{"servers": {@@ -129,11 +114,8 @@ 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{"context_servers": {@@ -145,19 +127,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{"mcpServers": {@@ -168,11 +144,8 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp}}```-### Установка в BoltAI-Откройте страницу "Settings", перейдите в "Plugins" и добавьте следующие JSON-строки:-```json{"mcpServers": {@@ -183,30 +156,23 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp}}```-### Установка в Copilot Coding Agent-Добавьте следующую конфигурацию в секцию `mcp` вашего файла настроек Copilot Coding Agent (Repository->Settings->Copilot->Coding agent->MCP configuration):-```json{"mcpServers": {"context7": {"type": "http","url": "https://mcp.context7.com/mcp",- "tools": ["get-library-docs", "resolve-library-id"]+ "tools": ["query-docs", "resolve-library-id"]}}}```-Подробнее см. в [официальной документации GitHub](https://docs.github.com/en/enterprise-cloud@latest/copilot/how-tos/agents/copilot-coding-agent/extending-copilot-coding-agent-with-mcp).-### Установка в Copilot CLI-1. Откройте файл конфигурации MCP Copilot CLI. Расположение: `~/.copilot/mcp-config.json` (где `~` — ваша домашняя папка).2. Добавьте следующее к объекту `mcpServers` в вашем файле `mcp-config.json`:-```json{"mcpServers": {@@ -216,69 +182,49 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp"headers": {"CONTEXT7_API_KEY": "YOUR_API_KEY"},- "tools": ["get-library-docs", "resolve-library-id"]+ "tools": ["query-docs", "resolve-library-id"]}}}```-Или для локального сервера:-```json{"mcpServers": {"context7": {"type": "local","command": "npx",- "tools": ["get-library-docs", "resolve-library-id"],+ "tools": ["query-docs", "resolve-library-id"],"args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]}}}```-Если файл `mcp-config.json` не существует, создайте его.-### Используя Docker-Если вы предпочитаете запускать MCP сервер в Docker контейнере:-1. **Создайте образ Docker:**-Во-первых, создайте `Dockerfile` в корне вашего проекта (или в любом другом месте):-<details><summary>Нажмите, чтобы просмотреть содержимое файла Dockerfile</summary>-```DockerfileFROM node:18-alpine-WORKDIR /app-# Установите последнюю версию пакета глобальноRUN npm install -g @upstash/context7-mcp-# Откройте стандартный порт, если это необходимо (необязательно, это зависит от взаимодействия с MCP клиентом)# EXPOSE 3000-# Стандартная команда для запуска сервераCMD ["context7-mcp"]```-</details>-Затем, соберите образ, используя тег (например, `context7-mcp`). **Убедитесь, что Docker Desktop (или демон Docker) работает.** Запустите следующую команду в этой же директории, где сохранён `Dockerfile`:-```bashdocker build -t context7-mcp .```-2. **Настройте ваш MCP клиент:**-Обновите вашу конфигурацию MCP клиента, чтобы использовать Docker команду.-_Пример для cline_mcp_settings.json:_-```json{"mcpServers": {@@ -293,13 +239,9 @@ 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{"mcpServers": {@@ -312,32 +254,23 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp}}```-### Доступные инструменты-- `resolve-library-id`: преобразует общее название библиотеки в совместимый с Context7 идентификатор.- - `libraryName` (обязательно)-- `get-library-docs`: получает документацию по библиотеке по совместимому с Context7 идентификатору.- - `context7CompatibleLibraryID` (обязательно)- - `topic` (необязательно): фокусирует документацию на определённой теме (например, "routing", "hooks")- - `page` (необязательно, по умолчанию 1): номер страницы для пагинации (1-10). Если контекста недостаточно, попробуйте page=2, page=3 и т.д. с той же темой.-+ - `query` (обязательно): вопрос или задача пользователя (для ранжирования по релевантности)+ - `libraryName` (обязательно): название библиотеки для поиска+- `query-docs`: получает документацию по библиотеке по совместимому с Context7 идентификатору.+ - `libraryId` (обязательно): точный совместимый с Context7 идентификатор (например, `/mongodb/docs`, `/vercel/next.js`)+ - `query` (обязательно): вопрос или задача для получения релевантной документации## Разработка-Склонируйте проект и установите зависимости:-```bash-bun i+pnpm i```-Сборка:-```bash-bun run build+pnpm run build```-### Пример локальной конфигурации-```json{"mcpServers": {@@ -348,19 +281,13 @@ bun run build}}```-### Тестирование с помощью инспектора MCP-```bashnpx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp```-## Решение проблем-### ERR_MODULE_NOT_FOUND-Если вы видите эту ошибку, используйте `bunx` вместо `npx`.-```json{"mcpServers": {@@ -371,13 +298,9 @@ npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp}}```-Зачастую это решает проблему с недостающими модулями, особенно в окружении, где `npx` некорректно устанавливает или разрешает библиотеки.-### Проблемы с разрешением ESM-Если вы сталкиваетесь с проблемой по типу: `Error: Cannot find module 'uriTemplate.js'`, попробуйте запустить команду с флагом `--experimental-vm-modules`:-```json{"mcpServers": {@@ -388,11 +311,8 @@ npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp}}```-### Проблемы с TLS/сертификатами-Используйте флаг `--experimental-fetch` c `npx`, чтобы избежать ошибки, связанные с TLS:-```json{"mcpServers": {@@ -403,35 +323,21 @@ 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)- [Income stream surfers: "Context7 + SequentialThinking MCPs: Это уже AGI?"](https://www.youtube.com/watch?v=-ggvzyLpK6o)@@ -440,11 +346,7 @@ 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 2299fa6d..a0e5dbdf 100644--- a/i18n/README.tr.md+++ b/i18n/README.tr.md@@ -1,7 +1,6 @@# Context7 MCP - Herhangi Bir Prompt İçin Güncel Kod Belgeleri[](https://context7.com) [](https://smithery.ai/server/@upstash/context7-mcp) [<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)-[](./README.zh-CN.md) [](./README.ko.md) [](./README.es.md) [](./README.fr.md) [-purple>)](./README.pt-BR.md) [](./README.it.md) [](./README.id-ID.md) [](./README.de.md) [](./README.ru.md) [](./README.tr.md)## ❌ Context7 Olmadan@@ -15,7 +14,6 @@ LLM'ler, kullandığınız kütüphaneler hakkında güncel olmayan veya genel b## ✅ Context7 İleContext7 MCP, güncel ve sürüme özel belgeleri ve kod örneklerini doğrudan kaynağından çeker ve doğrudan prompt'unuza yerleştirir.-Cursor'da prompt'unuza `use context7` ekleyin:```txt@@ -31,8 +29,7 @@ Context7, güncel kod örneklerini ve belgelerini doğrudan LLM'inizin içeriği- 1️⃣ Prompt'unuzu doğal bir şekilde yazın- 2️⃣ LLM'e `use context7` kullanmasını söyleyin- 3️⃣ Çalışan kod cevapları alın--Sekme değiştirme, var olmayan halüsinasyon API'ler, güncel olmayan kod üretimleri yok.+ Sekme değiştirme, var olmayan halüsinasyon API'ler, güncel olmayan kod üretimleri yok.## 🛠️ Başlangıç@@ -52,7 +49,6 @@ npx -y @smithery/cli install @upstash/context7-mcp --client claude### Cursor'da KurulumŞu yolu izleyin: `Settings` -> `Cursor Settings` -> `MCP` -> `Add new global MCP server`-Aşağıdaki yapılandırmayı Cursor `~/.cursor/mcp.json` dosyanıza yapıştırmanız önerilen yaklaşımdır. Ayrıca, proje klasörünüzde `.cursor/mcp.json` oluşturarak belirli bir projeye de kurabilirsiniz. Daha fazla bilgi için [Cursor MCP belgelerine](https://docs.cursor.com/context/model-context-protocol) bakabilirsiniz.```json@@ -68,7 +64,6 @@ Aşağıdaki yapılandırmayı Cursor `~/.cursor/mcp.json` dosyanıza yapıştı<details><summary>Alternatif: Bun Kullanın</summary>-```json{"mcpServers": {@@ -79,12 +74,9 @@ Aşağıdaki yapılandırmayı Cursor `~/.cursor/mcp.json` dosyanıza yapıştı}}```-</details>-<details><summary>Alternatif: Deno Kullanın</summary>-```json{"mcpServers": {@@ -95,13 +87,9 @@ Aşağıdaki yapılandırmayı Cursor `~/.cursor/mcp.json` dosyanıza yapıştı}}```-</details>-### Windsurf'te Kurulum-Bunu Windsurf MCP yapılandırma dosyanıza ekleyin. Daha fazla bilgi için [Windsurf MCP belgelerine](https://docs.windsurf.com/windsurf/mcp) bakabilirsiniz.-```json{"mcpServers": {@@ -112,14 +100,10 @@ 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)-Bunu VS Code MCP yapılandırma dosyanıza ekleyin. Daha fazla bilgi için [VS Code MCP belgelerine](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) bakabilirsiniz.-```json{"servers": {@@ -131,11 +115,8 @@ 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{"context_servers": {@@ -147,19 +128,13 @@ Bunu VS Code MCP yapılandırma dosyanıza ekleyin. Daha fazla bilgi için [VS C}}```-### Claude Code'da Kurulum-Bu 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 Kurulum-Bunu 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{"mcpServers": {@@ -170,65 +145,44 @@ Bunu Claude Desktop `claude_desktop_config.json` dosyanıza ekleyin. Daha fazla}}```-### Copilot Coding Agent Kurulumu-Aşağıdaki yapılandırmayı Copilot Coding Agent'ın `mcp` bölümüne ekleyin (Repository->Settings->Copilot->Coding agent->MCP configuration):-```json{"mcpServers": {"context7": {"type": "http","url": "https://mcp.context7.com/mcp",- "tools": ["get-library-docs", "resolve-library-id"]+ "tools": ["query-docs", "resolve-library-id"]}}}```-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-alpine-WORKDIR /app-# En son sürümü global olarak yükleyinRUN npm install -g @upstash/context7-mcp@latest-# Gerekirse varsayılan portu açın (isteğe bağlı, MCP istemci etkileşimine bağlıdır)# EXPOSE 3000-# Sunucuyu çalıştırmak için varsayılan komutCMD ["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 .```-2. **MCP İstemcinizi Yapılandırın:**-MCP istemcinizin yapılandırmasını Docker komutunu kullanacak şekilde güncelleyin.-_cline_mcp_settings.json için örnek:_-```json{"mcpServers": {@@ -243,34 +197,24 @@ 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.- - `libraryName` (gerekli)-- `get-library-docs`: Context7 uyumlu bir kütüphane ID'si kullanarak bir kütüphane için belgeleri getirir.- - `context7CompatibleLibraryID` (gerekli)- - `topic` (isteğe bağlı): Belgeleri belirli bir konuya odaklayın (örn. "routing", "hooks")- - `page` (isteğe bağlı, varsayılan 1): Sayfalama için sayfa numarası (1-10). Bağlam yeterli değilse, aynı konu ile page=2, page=3, vb. deneyin.-+ - `query` (gerekli): Kullanıcının sorusu veya görevi (alaka sıralaması için)+ - `libraryName` (gerekli): Aranacak kütüphane adı+- `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ştirme-Projeyi klonlayın ve bağımlılıkları yükleyin:-```bash-bun i+pnpm i```-Derleyin:-```bash-bun run build+pnpm run build```-### Yerel Yapılandırma Örneği-```json{"mcpServers": {@@ -281,19 +225,13 @@ bun run build}}```-### MCP Inspector ile Test Etme-```bashnpx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp@latest```-## Sorun Giderme-### ERR_MODULE_NOT_FOUND-Bu hatayı görürseniz, `npx` yerine `bunx` kullanmayı deneyin.-```json{"mcpServers": {@@ -304,13 +242,9 @@ 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{"mcpServers": {@@ -321,23 +255,14 @@ 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 Reddi-Context7 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)- [Income stream surfers: "Context7 + SequentialThinking MCP'leri: Bu AGI mi?"](https://www.youtube.com/watch?v=-ggvzyLpK6o)@@ -346,11 +271,7 @@ 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)-## Lisans-MITdiff --git a/i18n/README.uk.md b/i18n/README.uk.mdindex a381bd1d..315e0e2d 100644--- a/i18n/README.uk.md+++ b/i18n/README.uk.md@@ -1,7 +1,6 @@# Context7 MCP — Актуальна документація з прикладами коду для будь-якого запиту[](https://context7.com) [](https://smithery.ai/server/@upstash/context7-mcp) [<img alt="Install in VS Code (npx)" src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20Context7%20MCP&color=0098FF">](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%7B%22name%22%3A%22context7%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40upstash%2Fcontext7-mcp%40latest%22%5D%7D)-[](./README.zh-TW.md) [](./README.zh-CN.md) [](./README.ja.md) [](./README.ko.md) [](./README.es.md) [](./README.fr.md) [-purple>)](./README.pt-BR.md) [](./README.it.md) [](./README.id-ID.md) [](./README.de.md) [](./README.ru.md) [](./README.tr.md) [](./README.ar.md) [](./README.uk.md)## ❌ Без Context7@@ -15,7 +14,6 @@## ✅ З Context7Context7 MCP отримує актуальну, специфічну для версії документацію та приклади коду безпосередньо з джерела — і вбудовує їх прямо у ваш промпт.-Додайте `use context7` до вашого запиту в Cursor:```txt@@ -31,8 +29,7 @@ Context7 завантажує свіжі приклади коду й докум- 1️⃣ Написуйте ваш промпт природно- 2️⃣ Скажіть ШІ використати `use context7`- 3️⃣ Отримайте робочі відповіді з кодом--Без перемикання між вкладками, без неіснуючих API та без застарілого коду.+ Без перемикання між вкладками, без неіснуючих API та без застарілого коду.## 📚 Додавання проєктів@@ -44,10 +41,8 @@ Context7 завантажує свіжі приклади коду й докум- Node.js ≥ v18.0.0- Cursor, Windsurf, Claude Desktop або інший MCP-клієнт-<details><summary><b>Встановлення через Smithery</b></summary>-Для автоматичного встановлення Context7 MCP Server для будь-якого клієнта через [Smithery](https://smithery.ai/server/@upstash/context7-mcp):```bash@@ -57,20 +52,13 @@ 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{"mcpServers": {@@ -80,11 +68,8 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}}```-#### Підключення до локального сервера Cursor-[](https://cursor.com/install-mcp?name=context7&config=eyJjb21tYW5kIjoibnB4IC15IEB1cHN0YXNoL2NvbnRleHQ3LW1jcCJ9)-```json{"mcpServers": {@@ -95,12 +80,9 @@ 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{"mcpServers": {@@ -111,14 +93,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{"mcpServers": {@@ -134,18 +112,12 @@ 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": {@@ -155,9 +127,7 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}}```-#### Підключення до локального сервера Windsurf-```json{"mcpServers": {@@ -168,17 +138,12 @@ 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": {@@ -188,9 +153,7 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}}```-#### Підключення до локального сервера Trae-```json{"mcpServers": {@@ -201,19 +164,13 @@ 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": {@@ -224,9 +181,7 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}}```-#### Підключення до локального сервера VS Code-```json"mcp": {"servers": {@@ -238,16 +193,11 @@ 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{"mcp": {@@ -260,9 +210,7 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}}```-Або для локального сервера:-```json{"mcp": {@@ -276,14 +224,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{"context_servers": {@@ -295,16 +239,11 @@ 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{"mcpServers": {@@ -314,22 +253,17 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>"headers": {"CONTEXT7_API_KEY": "YOUR_API_KEY"},- "tools": ["get-library-docs", "resolve-library-id"]+ "tools": ["query-docs", "resolve-library-id"]}}}```-Детальніше див. в [офіційній документації 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{"mcpServers": {@@ -339,39 +273,31 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>"headers": {"CONTEXT7_API_KEY": "YOUR_API_KEY"},- "tools": ["get-library-docs", "resolve-library-id"]+ "tools": ["query-docs", "resolve-library-id"]}}}```-Або для локального сервера:-```json{"mcpServers": {"context7": {"type": "local","command": "npx",- "tools": ["get-library-docs", "resolve-library-id"],+ "tools": ["query-docs", "resolve-library-id"],"args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]}}}```-Якщо файл `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`:-```json{"mcpServers": {@@ -382,35 +308,23 @@ 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 --transport http context7 https://mcp.context7.com/mcp```-#### Підключення до локального сервера Claude Code-```shclaude mcp add context7 -- npx -y @upstash/context7-mcp```-</details>-<details><summary><b>Встановлення в Claude Desktop</b></summary>-Додайте це до вашого файлу `claude_desktop_config.json` у Claude Desktop. Детальніше див. у [документації Claude Desktop MCP](https://modelcontextprotocol.io/quickstart/user).-```json{"mcpServers": {@@ -421,26 +335,18 @@ claude mcp add context7 -- npx -y @upstash/context7-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{"mcpServers": {@@ -451,52 +357,33 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp}}```--Після збереження введіть у чаті `get-library-docs`, а потім ваш ідентифікатор документації Context7 (наприклад, `get-library-docs /nuxt/ui`). Додаткова інформація доступна на [сайті документації BoltAI](https://docs.boltai.com/docs/plugins/mcp-servers). Для BoltAI на iOS [див. цей посібник](https://docs.boltai.com/docs/boltai-mobile/mcp-servers).-+Після збереження введіть у чаті `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-alpine-WORKDIR /app-# Встановіть найновішу версію глобальноRUN npm install -g @upstash/context7-mcp-# Відкрийте стандартний порт, якщо потрібно (необов'язково, залежить від взаємодії з MCP-клієнтом)# EXPOSE 3000-# Стандартна команда для запуску сервераCMD ["context7-mcp"]```-</details>-Потім створіть образ, використовуючи тег (наприклад, `context7-mcp`). **Переконайтеся, що Docker Desktop (або демон Docker) запущений.** Виконайте наступну команду в тій же теці, де ви зберегли `Dockerfile`:-```bashdocker build -t context7-mcp .```-2. **Налаштуйте ваш MCP-клієнт:**-Оновіть конфігурацію вашого MCP-клієнта для використання Docker-команди.-_Приклад для cline_mcp_settings.json:_-```json{"mcpServers": {@@ -511,16 +398,11 @@ claude mcp add context7 -- npx -y @upstash/context7-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{"mcpServers": {@@ -533,36 +415,26 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp}}```-</details>-<details><summary><b>Встановлення в Augment Code</b></summary>-Для налаштування Context7 MCP в Augment Code ви можете використовувати або графічний інтерфейс, або ручну конфігурацію.-### **A. Використання інтерфейсу Augment Code**-1. Натисніть меню гамбургер.2. Виберіть **Settings**.3. Перейдіть до розділу **Tools**.4. Натисніть кнопку **+ Add MCP**.5. Введіть наступну команду:-```npx -y @upstash/context7-mcp@latest```-6. Назва MCP: **Context7**.7. Натисніть кнопку **Add**.-### **B. Ручна конфігурація**-1. Натисніть Cmd/Ctrl Shift P або перейдіть до меню гамбургер у панелі Augment2. Виберіть Edit Settings3. У розділі Advanced натисніть Edit in settings.json4. Додайте конфігурацію сервера до масиву `mcpServers` в об'єкті `augment.advanced`-```json"augment.advanced": {"mcpServers": [@@ -574,16 +446,11 @@ claude mcp add context7 -- npx -y @upstash/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": {@@ -594,9 +461,7 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp}}```-#### Підключення до локального сервера Roo Code-```json{"mcpServers": {@@ -607,33 +472,24 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp}}```-</details>-<details><summary><b>Встановлення в Zencoder</b></summary>-Для налаштування Context7 MCP в Zencoder виконайте наступні кроки:-1. Перейдіть до меню Zencoder (...)2. З випадного меню виберіть Agent tools3. Натисніть на Add custom MCP4. Додайте назву та конфігурацію сервера знизу і обов'язково натисніть кнопку Install-```json{"command": "npx","args": ["-y", "@upstash/context7-mcp@latest"]}```-</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{"mcpServers": {@@ -644,19 +500,14 @@ claude mcp add context7 -- npx -y @upstash/context7-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.3. Натисніть + Add new MCP.4. Додайте наступну конфігурацію:-```json{"mcpServers": {@@ -666,19 +517,14 @@ claude mcp add context7 -- npx -y @upstash/context7-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`.3. Натисніть на `Command` у верхньому лівому куті діалогу та виберіть опцію As JSON зі списку4. Додайте цю конфігурацію та натисніть `OK`-```json{"mcpServers": {@@ -689,20 +535,14 @@ claude mcp add context7 -- npx -y @upstash/context7-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`.3. Вставте конфігурацію, наведену нижче:-```json{"Context7": {@@ -714,18 +554,12 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp}}```-4. Натисніть `Save`, щоб застосувати зміни.-</details>-<details><summary><b>Встановлення в Opencode</b></summary>-Додайте це до вашого конфігураційного файлу Opencode. Детальніше див. у [документації Opencode MCP](https://opencode.ai/docs/mcp-servers).-#### Підключення до віддаленого сервера Opencode-```json"mcp": {"context7": {@@ -735,9 +569,7 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp}}```-#### Підключення до локального сервера Opencode-```json{"mcp": {@@ -749,25 +581,17 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp}}```-</details>-## 🔨 Доступні інструменти-Context7 MCP надає наступні інструменти, які можуть використовувати великі мовні моделі:-- `resolve-library-id`: Перетворює загальну назву бібліотеки на сумісний з Context7 ідентифікатор бібліотеки.+ - `query` (обов'язково): Питання або завдання користувача (для ранжування за релевантністю)- `libraryName` (обов'язково): Назва бібліотеки для пошуку--- `get-library-docs`: Отримує документацію для бібліотеки, використовуючи сумісний з Context7 ідентифікатор бібліотеки.- - `context7CompatibleLibraryID` (обов'язково): Точний сумісний з Context7 ідентифікатор бібліотеки (наприклад, `/mongodb/docs`, `/vercel/next.js`)- - `topic` (необов'язково): Сфокусувати документацію на конкретній темі (наприклад, "routing", "hooks")- - `page` (необов'язково, за замовчуванням 1): Номер сторінки для пагінації (1-10). Якщо контексту недостатньо, спробуйте page=2, page=3 тощо з тією ж темою.-+- `query-docs`: Отримує документацію для бібліотеки, використовуючи сумісний з Context7 ідентифікатор бібліотеки.+ - `libraryId` (обов'язково): Точний сумісний з Context7 ідентифікатор бібліотеки (наприклад, `/mongodb/docs`, `/vercel/next.js`)+ - `query` (обов'язково): Питання або завдання для отримання релевантної документації## 🛟 Поради-### Додайте правило-> Якщо ви не хочете додавати `use context7` до кожного промпту, ви можете визначити просте правило у вашому файлі `.windsurfrules` в Windsurf або в розділі `Cursor Settings > Rules` в Cursor (або еквівалентному у вашому MCP-клієнті), щоб автоматично викликати Context7 для будь-яких запитань про код:>> ```toml@@ -777,9 +601,7 @@ Context7 MCP надає наступні інструменти, які можу> ```>> Відтоді ви отримуватимете документацію Context7 у будь-якій пов'язаній розмові без введення будь-чого додаткового. Ви можете додати свої випадки використання до частини match.-### Використовуйте ідентифікатор бібліотеки-> Якщо ви вже точно знаєте, яку бібліотеку хочете використовувати, додайте її ідентифікатор Context7 до вашого промпту. Таким чином Context7 MCP-сервер може пропустити крок пошуку бібліотеки та одразу перейти до отримання документації.>> ```txt@@ -787,43 +609,29 @@ Context7 MCP надає наступні інструменти, які можу> ```>> Синтаксис із слешем повідомляє MCP-інструменту точно, для якої бібліотеки завантажувати документацію.-## 💻 Розробка-Склонуйте проєкт і встановіть залежності:-```bash-bun i+pnpm i```-Збирання:-```bash-bun run build+pnpm run build```-Запуск сервера:-```bash-bun run dist/index.js+node packages/mcp/dist/index.js```-### Аргументи командного рядка-`context7-mcp` приймає наступні прапори CLI:-- `--transport <stdio|http>` — Транспорт для використання (`stdio` за замовчуванням).- `--port <number>` — Порт для прослуховування при використанні транспорту `http` (за замовчуванням `3000`).-Приклад з http-транспортом і портом 8080:-```bash-bun run dist/index.js --transport http --port 8080+node packages/mcp/dist/index.js --transport http --port 8080```-<details><summary><b>Приклад локальної конфігурації</b></summary>-```json{"mcpServers": {@@ -834,25 +642,17 @@ bun run 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{"mcpServers": {@@ -863,16 +663,11 @@ 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{"mcpServers": {@@ -883,14 +678,10 @@ npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp}}```-</details>-<details><summary><b>Проблеми TLS/сертифікатів</b></summary>-Використовуйте прапор `--experimental-fetch`, щоб обійти проблеми, пов'язані з TLS:-```json{"mcpServers": {@@ -901,33 +692,22 @@ 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)- [Income Stream Surfers: "Context7 + SequentialThinking MCPs: Is This AGI?"](https://www.youtube.com/watch?v=-ggvzyLpK6o)@@ -936,11 +716,7 @@ 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 4e67ded0..303f7dc6 100644--- a/i18n/README.vi.md+++ b/i18n/README.vi.md@@ -1,7 +1,6 @@# Context7 MCP - Tài Liệu Code Cập Nhật Cho Mọi Prompt[](https://context7.com) [](https://smithery.ai/server/@upstash/context7-mcp) [<img alt="Install in VS Code (npx)" src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=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)-[](./README.zh-TW.md) [](./README.zh-CN.md) [](./README.ja.md) [](./README.ko.md) [](./README.es.md) [](./README.fr.md) [-purple>)](./README.pt-BR.md) [](./README.it.md) [](./README.id-ID.md) [](./README.de.md) [](./README.ru.md) [](./README.uk.md) [](./README.tr.md) [](./README.ar.md) [](./README.vi.md)## ❌ Không có Context7@@ -15,7 +14,6 @@ Các LLM dựa vào thông tin lỗi thời hoặc chung chung về các thư vi## ✅ Với Context7Context7 MCP lấy tài liệu và ví dụ code cập nhật, dành cho phiên bản cụ thể trực tiếp từ nguồn gốc — và đặt chúng trực tiếp vào prompt của bạn.-Thêm `use context7` vào prompt của bạn trong Cursor:```txt@@ -31,8 +29,7 @@ Context7 lấy các ví dụ code và tài liệu cập nhật ngay vào context- 1️⃣ Viết prompt một cách tự nhiên- 2️⃣ Nói với LLM để `use context7`- 3️⃣ Nhận được câu trả lời code hoạt động--Không cần chuyển tab, không có API tự tạo không tồn tại, không có code generation lỗi thời.+ Không cần chuyển tab, không có API tự tạo không tồn tại, không có code generation lỗi thời.## 📚 Thêm Dự Án@@ -44,10 +41,8 @@ Xem [hướng dẫn thêm dự án](./adding-projects.md) để học cách thê- Node.js >= v18.0.0- 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@@ -57,20 +52,13 @@ 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{"mcpServers": {@@ -80,11 +68,8 @@ 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{"mcpServers": {@@ -95,12 +80,9 @@ 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{"mcpServers": {@@ -111,14 +93,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{"mcpServers": {@@ -134,18 +112,12 @@ 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": {@@ -155,9 +127,7 @@ 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": {@@ -168,17 +138,12 @@ 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": {@@ -188,9 +153,7 @@ 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": {@@ -201,19 +164,13 @@ 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": {@@ -224,9 +181,7 @@ 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": {@@ -238,16 +193,11 @@ 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{"mcp": {@@ -260,9 +210,7 @@ Thêm cấu hình này vào file cấu hình Visual Studio MCP của bạn (xem}}```-Hoặc, cho local server:-```json{"mcp": {@@ -276,16 +224,11 @@ 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{"context_servers": {@@ -297,17 +240,12 @@ 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:-```json{"mcpServers": {@@ -317,9 +255,7 @@ Xem [Cấu hình Gemini CLI](https://github.com/google-gemini/gemini-cli/blob/ma}}```-Hoặc, cho local server:-```json{"mcpServers": {@@ -330,35 +266,23 @@ 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 Remote Server-```shclaude mcp add --transport http context7 https://mcp.context7.com/mcp```-#### Kết nối Claude Code Local Server-```shclaude mcp add context7 -- npx -y @upstash/context7-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{"mcpServers": {@@ -369,28 +293,20 @@ 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{"mcpServers": {@@ -401,52 +317,33 @@ Mở trang "Settings" của ứng dụng, điều hướng đến "Plugins," và}}```--Sau khi lưu, nhập trong chat `get-library-docs` theo sau bởi Context7 documentation ID của bạn (ví dụ: `get-library-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).-+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-alpine-WORKDIR /app-# Cài đặt phiên bản mới nhất globallyRUN npm install -g @upstash/context7-mcp-# Expose default port nếu cần (tùy chọn, phụ thuộc vào tương tác MCP client)# EXPOSE 3000-# Lệnh mặc định để chạy serverCMD ["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 .```-2. **Cấu hình MCP Client của bạn:**-Cập nhật cấu hình MCP client của bạn để sử dụng lệnh Docker.-_Ví dụ cho cline_mcp_settings.json:_-```json{"mcpServers": {@@ -461,16 +358,11 @@ 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{"mcpServers": {@@ -483,40 +375,28 @@ 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**.3. Điều hướng đến phần **Tools**.4. Click nút **+ Add MCP**.5. Nhập lệnh sau:-```npx -y @upstash/context7-mcp@latest```-6. Đặt tên MCP: **Context7**.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 Settings3. Trong Advanced, click Edit in settings.json4. Thêm cấu hình server vào mảng `mcpServers` trong object `augment.advanced`-"augment.advanced": {"mcpServers": [{@@ -526,18 +406,12 @@ 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": {@@ -548,9 +422,7 @@ 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": {@@ -561,35 +433,25 @@ 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 tools3. Click vào Add custom MCP4. Thêm tên và cấu hình server từ bên dưới, và đảm bảo nhấn nút Install-```json{"command": "npx","args": ["-y", "@upstash/context7-mcp@latest"]}```-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{"mcpServers": {@@ -600,19 +462,14 @@ 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.3. Click + Add new MCP.4. Thêm cấu hình sau:-```json{"mcpServers": {@@ -622,19 +479,14 @@ 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`.3. Click vào `Command` ở góc trên bên trái của dialog và chọn tùy chọn As JSON từ danh sách4. Thêm cấu hình này và click `OK`-```json{"mcpServers": {@@ -645,21 +497,15 @@ Xem [Tài liệu JetBrains AI Assistant](https://www.jetbrains.com/help/ai-assis}}```-5. 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`.3. Paste cấu hình được cung cấp bên dưới:-```json{"Context7": {@@ -671,18 +517,12 @@ 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": {@@ -692,9 +532,7 @@ 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": {@@ -706,39 +544,28 @@ 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 Agent-Thê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{"mcpServers": {"context7": {"type": "http","url": "https://mcp.context7.com/mcp",- "tools": ["get-library-docs", "resolve-library-id"]+ "tools": ["query-docs", "resolve-library-id"]}}}```-Để 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{"mcpServers": {@@ -748,41 +575,32 @@ Thêm cấu hình sau vào phần `mcp` trong file cấu hình Copilot Coding Ag"headers": {"CONTEXT7_API_KEY": "YOUR_API_KEY"},- "tools": ["get-library-docs", "resolve-library-id"]+ "tools": ["query-docs", "resolve-library-id"]}}}```-Hoặc, đối với server cục bộ:-```json{"mcpServers": {"context7": {"type": "local","command": "npx",- "tools": ["get-library-docs", "resolve-library-id"],+ "tools": ["query-docs", "resolve-library-id"],"args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]}}}```-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`.3. Paste cấu hình được cung cấp bên dưới:-```json{"mcpServers": {@@ -796,48 +614,33 @@ 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:-```json{"mcpServers": {@@ -848,28 +651,19 @@ Xem [LM Studio MCP Support](https://lmstudio.ai/blog/lmstudio-v0.3.17) để bi}}```-3. 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ẵn-Context7 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.+ - `query` (bắt buộc): Câu hỏi hoặc nhiệm vụ của người dùng (để xếp hạng độ liên quan)- `libraryName` (bắt buộc): Tên của thư viện cần tìm kiếm--- `get-library-docs`: Lấy tài liệu cho thư viện sử dụng Context7-compatible library ID.- - `context7CompatibleLibraryID` (bắt buộc): Context7-compatible library ID chính xác (ví dụ: `/mongodb/docs`, `/vercel/next.js`)- - `topic` (tùy chọn): Tập trung tài liệu vào một chủ đề cụ thể (ví dụ: "routing", "hooks")- - `page` (tùy chọn, mặc định 1): Số trang cho phân trang (1-10). Nếu ngữ cảnh không đủ, hãy thử page=2, page=3, v.v. với cùng chủ đề.-+- `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:>> ```toml@@ -879,9 +673,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.>> ```txt@@ -889,43 +681,29 @@ 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ển-Clone dự án và cài đặt dependencies:-```bash-bun i+pnpm i```-Build:-```bash-bun run build+pnpm run build```-Chạy server:-```bash-bun run dist/index.js+node 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).- `--port <number>` – Port để lắng nghe khi sử dụng transport `http` (mặc định `3000`).-Ví dụ với http transport và port 8080:-```bash-bun run dist/index.js --transport http --port 8080+node packages/mcp/dist/index.js --transport http --port 8080```-<details><summary><b>Ví dụ Cấu hình Local</b></summary>-```json{"mcpServers": {@@ -936,25 +714,17 @@ bun run 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{"mcpServers": {@@ -965,16 +735,11 @@ 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{"mcpServers": {@@ -985,14 +750,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{"mcpServers": {@@ -1003,33 +764,22 @@ 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ệm-Cá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ôi-Cậ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)- [Income Stream Surfers: "Context7 + SequentialThinking MCPs: Is This AGI?"](https://www.youtube.com/watch?v=-ggvzyLpK6o)@@ -1038,11 +788,7 @@ 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ép-MITdiff --git a/i18n/README.zh-CN.md b/i18n/README.zh-CN.mdindex 5673bb59..a1b5925e 100644--- a/i18n/README.zh-CN.md+++ b/i18n/README.zh-CN.md@@ -3,9 +3,7 @@# Context7 MCP - 为所有 Prompt 获取最新文档[](https://context7.com) [](https://smithery.ai/server/@upstash/context7-mcp)-[](https://cursor.com/en/install-mcp?name=context7&config=eyJ1cmwiOiJodHRwczovL21jcC5jb250ZXh0Ny5jb20vbWNwIn0%3D) [<img alt="Install in VS Code (npx)" src="https://img.shields.io/badge/Install%20in%20VS%20Code-0098FF?style=for-the-badge&logo=visualstudiocode&logoColor=white">](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)-[](../README.md) [](./README.zh-TW.md) [](./README.ja.md) [](./README.ko.md) [](./README.es.md) [](./README.fr.md) [-purple>)](./README.pt-BR.md) [](./README.it.md) [](./README.id-ID.md) [](./README.de.md) [](./README.ru.md) [](./README.uk.md) [](./README.tr.md) [](./README.ar.md) [](./README.vi.md)## ❌ 不使用Context7@@ -19,7 +17,6 @@## ✅ 使用Context7Context7 MCP直接从源头获取最新的、特定版本的文档和代码示例 — 并将它们直接放入你的提示中。-在Cursor中添加`使用 context7`到你的提示:```txt@@ -35,8 +32,7 @@ Context7将最新的代码示例和文档直接获取到你的LLM上下文中。- 1️⃣ 按照往常,自然地编写你的提示- 2️⃣ 告诉LLM`使用 context7`- 3️⃣ 获取可用的代码回复--无需在标签间切换,不存在幻觉API,不会生成过时的代码生成。+ 无需在标签间切换,不存在幻觉API,不会生成过时的代码生成。## 📚 添加项目@@ -49,10 +45,8 @@ Context7将最新的代码示例和文档直接获取到你的LLM上下文中。- Node.js >= v18.0.0- Cursor, Claude Code, VSCode, Windsurf 或其他MCP客户端- 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@@ -62,20 +56,13 @@ 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{"mcpServers": {@@ -88,11 +75,8 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}}```-#### Cursor 本地服务器连接-[](https://cursor.com/en/install-mcp?name=context7&config=eyJjb21tYW5kIjoibnB4IC15IEB1cHN0YXNoL2NvbnRleHQ3LW1jcCJ9)-```json{"mcpServers": {@@ -103,35 +87,23 @@ 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 --transport http context7 https://mcp.context7.com/mcp --header "CONTEXT7_API_KEY: YOUR_API_KEY"```-#### Claude Code 本地服务器连接-```shclaude mcp add context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY```-</details>-<details><summary><b>在 Windsurf 中安装</b></summary>-将此内容添加到你的 Windsurf MCP 配置文件中。更多信息请参阅 [Windsurf MCP 文档](https://docs.windsurf.com/windsurf/cascade/mcp)。-#### Windsurf 远程服务器连接-```json{"mcpServers": {@@ -144,9 +116,7 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY}}```-#### Windsurf 本地服务器连接-```json{"mcpServers": {@@ -157,19 +127,13 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY}}```-</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": {@@ -183,9 +147,7 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY}}```-#### VS Code 本地服务器连接-```json"mcp": {"servers": {@@ -197,29 +159,22 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY}}```-</details>-<details><summary><b>在 Cline 中安装</b></summary>-您可以通过以下步骤轻松地通过 [Cline MCP Server 市场](https://cline.bot/mcp-marketplace) 安装 Context7:-1. 打开 **Cline**。2. 点击菜单图标 (☰),进入 **MCP 服务器** 部分。3. 在 **市场** 标签页中的搜索栏搜索 _Context7_。4. 点击 **安装** 按钮。-您也可以直接修改MCP servers设置文件:-1. 打开**Cline**。2. 点击菜单图标 (☰),进入 **MCP 服务器** 部分。3. 选择 **远程服务器** 标签。4. 点击 **编辑配置** 按钮。5. 将 context7 相关设置添加到 `mcpServers`:-```json{"mcpServers": {@@ -233,14 +188,10 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY}}```-</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{"context_servers": {@@ -252,40 +203,28 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY}}```-</details>-<details><summary><b>在 Augment Code 中安装</b></summary>-要在 Augment Code 中配置 Context7 MCP,您可以使用图形界面或手动配置两种方式。-### **A. 在 Augment Code Code UI 中使用**-1. 点击 hamburger 菜单。2. 选择 **Settings**。3. 进入 **Tools** 部分。4. 点击 **+ Add MCP** 按钮。5. 输入以下命令:-```npx -y @upstash/context7-mcp@latest```-6. 给 MCP 命名为:**Context7**。7. 点击 **Add** 按钮。-添加 MCP 服务器后,您即可在 Augment Code 内直接使用 Context7 提供的最新代码文档功能。-----### **B. 手动配置**-1. 按下 Cmd/Ctrl + Shift + P,或在 Augment 面板点击 hamburger 菜单。2. 选择编辑设置 (Edit Settings)。3. 在高级设置中,点击在 settings.json 中编辑 (Edit in settings.json)。4. 将服务器配置添加到 `augment.advanced` 对象中的 `mcpServers` 数组中。-```json"augment.advanced": {"mcpServers": [@@ -297,18 +236,12 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY]}```-添加 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": {@@ -319,9 +252,7 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY}}```-#### Roo Code 本地服务器连接-```json{"mcpServers": {@@ -332,17 +263,12 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY}}```-</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` 对象:-```json{"mcpServers": {@@ -355,9 +281,7 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY}}```-或者,对于本地服务器:-```json{"mcpServers": {@@ -368,22 +292,14 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY}}```-如果 `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{"mcpServers": {@@ -394,16 +310,11 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY}}```-</details>-<details><summary><b>在 Opencode 中安装</b></summary>-将此内容添加到您的 Opencode 配置文件中。更多信息请参见 [Opencode MCP 文档](https://opencode.ai/docs/mcp-servers)。-#### Opencode 远程服务器连接-```json"mcp": {"context7": {@@ -416,9 +327,7 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY}}```-#### Opencode 本地服务器连接-```json{"mcp": {@@ -430,43 +339,31 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY}}```-</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`。3. 在对话框左上角点击 `Command`,然后从列表中选择 “以 JSON 形式”。4. 添加以下配置并点击 `OK`。-```json{"mcpServers": {@@ -477,21 +374,15 @@ 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 服务器。3. 粘贴以下配置内容:-```json{"mcpServers": {@@ -505,19 +396,13 @@ 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": {@@ -527,9 +412,7 @@ http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }}}```-#### Trae 本地服务器连接-```json{"mcpServers": {@@ -540,16 +423,11 @@ http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }}}```-</details>-<details><summary><b>在 Bun 或 Deno 中使用</b></summary>-使用以下替代方法,在其他运行环境中运行本地 Context7 MCP 服务器。这些示例适用于任何支持通过命令 + 参数启动本地 MCP 服务器的客户端。-#### Bun-```json{"mcpServers": {@@ -560,9 +438,7 @@ http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }}}```-#### Deno-```json{"mcpServers": {@@ -578,50 +454,32 @@ 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-alpine-WORKDIR /app-# 全局安装最新版本RUN npm install -g @upstash/context7-mcp-# 如果需要,暴露默认端口(可选,取决于 MCP 客户端交互)# EXPOSE 3000-# 运行服务器的默认命令CMD ["context7-mcp"]```-</details>-然后,使用标签(例如,`context7-mcp`)构建镜像。**确保 Docker Desktop(或 Docker 守护进程)正在运行。** 在保存 `Dockerfile` 的同一目录中运行以下命令:-```bashdocker build -t context7-mcp .```-2. **配置MCP客户端:**-更新MCP客户端配置以使用Docker命令。-_cline_mcp_settings.json配置示例:_-```json{"mcpServers": {@@ -636,23 +494,15 @@ 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{"mcpServers": {@@ -665,14 +515,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{"mcpServers": {@@ -683,18 +529,13 @@ 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 服务器。3. 粘贴以下配置内容:-```json{"Context7": {@@ -706,18 +547,12 @@ 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{"mcpServers": {@@ -727,22 +562,17 @@ http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }"headers": {"CONTEXT7_API_KEY": "YOUR_API_KEY"},- "tools": ["get-library-docs", "resolve-library-id"]+ "tools": ["query-docs", "resolve-library-id"]}}}```-更多信息请见 [官方 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{"mcpServers": {@@ -752,45 +582,34 @@ http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }"headers": {"CONTEXT7_API_KEY": "YOUR_API_KEY"},- "tools": ["get-library-docs", "resolve-library-id"]+ "tools": ["query-docs", "resolve-library-id"]}}}```-或者,对于本地服务器:-```json{"mcpServers": {"context7": {"type": "local","command": "npx",- "tools": ["get-library-docs", "resolve-library-id"],+ "tools": ["query-docs", "resolve-library-id"],"args": ["-y", "@upstash/context7-mcp", "--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. 粘贴以下配置内容:-```json{"mcpServers": {@@ -801,19 +620,13 @@ 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{"mcp": {@@ -826,9 +639,7 @@ http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }}}```-或者,对于本地服务器:-```json{"mcp": {@@ -842,23 +653,16 @@ 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",@@ -873,9 +677,7 @@ http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }}}```-#### Crush 本地服务器连接-```json{"$schema": "https://charm.land/crush.json",@@ -888,14 +690,10 @@ http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }}}```-</details>-<details><summary><b>在 BoltAI 中安装</b></summary>-打开应用的“Settings”页面,导航到“Plugins”,然后输入以下 JSON:-```json{"mcpServers": {@@ -906,24 +704,16 @@ http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }}}```--保存后,在聊天中输入 `get-library-docs`,后跟您的 Context7 文档 ID(例如,`get-library-docs /nuxt/ui`)。更多信息请访问 [BoltAI 的文档网站](https://docs.boltai.com/docs/plugins/mcp-servers)。有关 iOS 版 BoltAI,请参见[此指南](https://docs.boltai.com/docs/boltai-mobile/mcp-servers)。-+保存后,在聊天中输入 `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": {@@ -933,9 +723,7 @@ acli rovodev mcp}}```-#### 本地服务器连接-```json{"mcpServers": {@@ -946,43 +734,30 @@ acli rovodev mcp}}```-</details>-<details><summary><b>在 Zencoder 中安装</b></summary>-要在 Zencoder 中配置 Context7 MCP,请按照以下步骤操作:-1. 进入 Zencoder 菜单(...)2. 从下拉菜单中选择 Agent tools3. 点击 Add custom MCP4. 添加以下名称和服务器配置,确保点击安装按钮-```json{"command": "npx","args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]}```-一旦添加了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": {@@ -993,9 +768,7 @@ acli rovodev mcp}}```-#### Qodo Gen 远程服务器连接-```json{"mcpServers": {@@ -1005,21 +778,16 @@ 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. 选择 `连接器`。3. 点击 `添加连接器`。4. 选择 `高级`。5. 输入服务器名称:`Context7`6. 在文本区域粘贴以下 JSON:-```json{"args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"],@@ -1027,26 +795,18 @@ acli rovodev mcp"env": {}}```-7. 点击 `保存`。</details>-## 🔨 可用工具-Context7 MCP 提供以下 LLM 可以使用的工具:-- `resolve-library-id`:将通用库名称解析为 Context7 兼容的库 ID。+ - `query`(必需):用户的问题或任务(用于相关性排名)- `libraryName`(必需):要搜索的库名称--- `get-library-docs`:使用 Context7 兼容的库 ID 获取库的文档。- - `context7CompatibleLibraryID`(必需):精确的 Context7 兼容库 ID(例如,`/mongodb/docs`、`/vercel/next.js`)- - `topic`(可选):将文档重点放在特定主题上(例如,"routing"、"hooks")- - `page`(可选,默认 1):分页的页码(1-10)。如果上下文不够,请尝试使用相同主题的 page=2、page=3 等。-+- `query-docs`:使用 Context7 兼容的库 ID 获取库的文档。+ - `libraryId`(必需):精确的 Context7 兼容库 ID(例如,`/mongodb/docs`、`/vercel/next.js`)+ - `query`(必需):用于获取相关文档的问题或任务## 🛟 技巧-### 添加规则-> 如果你不想在每个提示中添加 `use context7`,你可以在 Windsurf 的 `.windsurfrules` 文件中或从 Cursor 的 `Cursor Settings > Rules` 部分(或你的 MCP 客户端中的等效位置)定义一个简单规则,以在任何代码问题上自动调用 Context7:>> ```toml@@ -1056,9 +816,7 @@ Context7 MCP 提供以下 LLM 可以使用的工具:> ```>> 从那时起,你将在任何相关对话中获得 Context7 的文档,而无需键入任何额外内容。你可以将你的用例添加到匹配部分。-### 使用库 ID-> 如果你已经确切地知道要使用哪个库,请将其 Context7 ID 添加到你的提示中。这样,Context7 MCP 服务器可以跳过库匹配步骤,直接继续检索文档。>> ```txt@@ -1066,50 +824,34 @@ Context7 MCP 提供以下 LLM 可以使用的工具:> ```>> 斜杠语法告诉 MCP 工具确切要为哪个库加载文档。-## 💻 开发-克隆项目并安装依赖:-```bash-bun i+pnpm i```-构建:-```bash-bun run build+pnpm run build```-运行服务器:-```bash-bun run dist/index.js+node packages/mcp/dist/index.js```-### CLI 参数-`context7-mcp` 接受以下 CLI 标志:-- `--transport <stdio|http>` – 使用的传输方式(默认 `stdio`)。使用 `http` 作为远程 HTTP 服务器或 `stdio` 用于本地集成。- `--port <number>` – 使用 `http` 传输时监听的端口(默认 `3000`)。- `--api-key <key>` – 用于身份验证的API密钥。您可以通过在 [context7.com/dashboard](https://context7.com/dashboard) 创建账户来获取您的API密钥。-使用 http 传输和端口 8080 的示例:-```bash-bun run dist/index.js --transport http --port 8080+node packages/mcp/dist/index.js --transport http --port 8080```-另一个使用 stdio 传输 的示例:-```bash-bun run dist/index.js --transport stdio --api-key YOUR_API_KEY+node packages/mcp/dist/index.js --transport stdio --api-key YOUR_API_KEY```-<details><summary><b>本地配置示例</b></summary>-```json{"mcpServers": {@@ -1120,25 +862,17 @@ bun run 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{"mcpServers": {@@ -1149,16 +883,11 @@ 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{"mcpServers": {@@ -1169,14 +898,10 @@ npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp}}```-</details>-<details><summary><b>TLS/证书问题</b></summary>-使用 `--experimental-fetch` 标志绕过 TLS 相关问题:-```json{"mcpServers": {@@ -1187,36 +912,22 @@ 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)- [Income Stream Surfers: "Context7 + SequentialThinking MCPs:这是 AGI 吗?"](https://www.youtube.com/watch?v=-ggvzyLpK6o)@@ -1225,11 +936,7 @@ 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 2bde614f..b1e8b1ca 100644--- a/i18n/README.zh-TW.md+++ b/i18n/README.zh-TW.md@@ -13,7 +13,6 @@## ✅ 有了 Context7Context7 MCP 直接從來源拉取即時、特定版本的文件與程式碼範例,並直接放入你的提示中。-在 Cursor 的提示中加入 `use context7`:```txt@@ -29,8 +28,7 @@ Context7 會將即時的程式碼範例與文件直接帶入你的 LLM 上下文- 1️⃣ 自然地撰寫你的提示- 2️⃣ 告訴 LLM `use context7`- 3️⃣ 取得可執行的程式碼解答--不需切換分頁、不會產生不存在的 API、不會有過時的程式碼。+ 不需切換分頁、不會產生不存在的 API、不會有過時的程式碼。## 📚 新增專案@@ -42,10 +40,8 @@ Context7 會將即時的程式碼範例與文件直接帶入你的 LLM 上下文- Node.js >= v18.0.0- Cursor、Windsurf、Claude Desktop 或其他 MCP 客戶端-<details><summary><b>透過 Smithery 安裝</b></summary>-要透過 [Smithery](https://smithery.ai/server/@upstash/context7-mcp) 自動安裝 Context7 MCP Server:```bash@@ -55,16 +51,11 @@ 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": {@@ -74,11 +65,8 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}}```-#### Cursor 本地伺服器連線-[](https://cursor.com/install-mcp?name=context7&config=eyJjb21tYW5kIjoibnB4IC15IEB1cHN0YXNoL2NvbnRleHQ3LW1jcCJ9)-```json{"mcpServers": {@@ -89,12 +77,9 @@ 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{"mcpServers": {@@ -105,14 +90,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{"mcpServers": {@@ -123,18 +104,12 @@ 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": {@@ -144,9 +119,7 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}}```-#### Windsurf 本地伺服器連線-```json{"mcpServers": {@@ -157,17 +130,12 @@ 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": {@@ -177,9 +145,7 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}}```-#### Trae 本地伺服器連線-```json{"mcpServers": {@@ -190,19 +156,13 @@ 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": {@@ -213,9 +173,7 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}}```-#### VS Code 本地伺服器連線-```json"mcp": {"servers": {@@ -227,16 +185,11 @@ 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{"mcp": {@@ -249,9 +202,7 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}}```-或者,若要使用本地伺服器:-```json{"mcp": {@@ -265,16 +216,11 @@ 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{"context_servers": {@@ -286,17 +232,12 @@ 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` 物件內新增以下內容:-```json{"mcpServers": {@@ -306,9 +247,7 @@ npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>}}```-或者,若要使用本地伺服器:-```json{"mcpServers": {@@ -319,35 +258,23 @@ 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 --transport http context7 https://mcp.context7.com/mcp```-#### Claude Code 本地伺服器連線-```shclaude mcp add context7 -- npx -y @upstash/context7-mcp```-</details>-<details><summary><b>在 Claude Desktop 安裝</b></summary>-將下列內容加入 Claude Desktop `claude_desktop_config.json`。詳見 [Claude Desktop MCP 文件](https://modelcontextprotocol.io/quickstart/user)。-```json{"mcpServers": {@@ -358,29 +285,22 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp}}```-</details>-<details><summary><b>在 Cline 安裝</b></summary>-您可以按照以下說明,透過 [Cline MCP 伺服器市集](https://cline.bot/mcp-marketplace) 輕鬆安裝 Context7:-1. 開啟 **Cline**。2. 點擊選單圖示(☰)進入 **MCP 伺服器** 區段。3. 在 **市集** 分頁的搜尋欄中尋找 _Context7_。4. 點擊 **安裝** 按鈕。-您也可以直接修改 MCP servers 設定檔案:-1. 開啟 Cline。2. 點擊選單圖示 (☰),進入 MCP 伺服器部分。3. 選擇遠端伺服器標籤。4. 點擊編輯設定按鈕。5. 將 context7 相關設定新增至 mcpServers:-```json{"mcpServers": {@@ -394,14 +314,10 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp}}```-</details>-<details><summary><b>在 BoltAI 安裝</b></summary>-打開應用程式的「Settings」頁面,前往「Plugins」,並輸入下列 JSON:-```json{"mcpServers": {@@ -412,40 +328,29 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp}}```--儲存後,在聊天中輸入 `get-library-docs` 並接上你的 Context7 文件 ID(例如 `get-library-docs /nuxt/ui`)。更多資訊請參考 [BoltAI 文件網站](https://docs.boltai.com/docs/plugins/mcp-servers)。如在 iOS 上使用 BoltAI,請參考[此指南](https://docs.boltai.com/docs/boltai-mobile/mcp-servers)。-+儲存後,在聊天中輸入 `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{"mcpServers": {"context7": {"type": "http","url": "https://mcp.context7.com/mcp",- "tools": ["get-library-docs", "resolve-library-id"]+ "tools": ["query-docs", "resolve-library-id"]}}}```-更多資訊請參見[官方 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{"mcpServers": {@@ -455,72 +360,51 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp"headers": {"CONTEXT7_API_KEY": "YOUR_API_KEY"},- "tools": ["get-library-docs", "resolve-library-id"]+ "tools": ["query-docs", "resolve-library-id"]}}}```-或者,對於本地伺服器:-```json{"mcpServers": {"context7": {"type": "local","command": "npx",- "tools": ["get-library-docs", "resolve-library-id"],+ "tools": ["query-docs", "resolve-library-id"],"args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]}}}```-如果 `mcp-config.json` 檔案不存在,請建立它。-</details>-<details><summary><b>使用 Docker</b></summary>-若你偏好在 Docker 容器中執行 MCP 伺服器:-1. **建立 Docker 映像檔:**-先在專案根目錄(或任意位置)建立 `Dockerfile`:-<details><summary>點擊查看 Dockerfile 內容</summary>-```DockerfileFROM node:18-alpine-WORKDIR /app-# 全域安裝最新版RUN npm install -g @upstash/context7-mcp-# 如有需要可開放預設埠(視 MCP 客戶端互動而定)# EXPOSE 3000-# 預設啟動指令CMD ["context7-mcp"]```-</details>-然後使用標籤(如 `context7-mcp`)建構映像檔。**請確保 Docker Desktop(或 Docker daemon)已啟動。**在存有 `Dockerfile` 的目錄執行:-```bashdocker build -t context7-mcp .```-2. **設定 MCP 客戶端:**-更新 MCP 客戶端設定以使用 Docker 指令。-_cline_mcp_settings.json 範例:_-```json{"mcpServers": {@@ -535,16 +419,11 @@ claude mcp add context7 -- npx -y @upstash/context7-mcp}}```-_注意:這是範例設定。請參考前述各 MCP 客戶端(如 Cursor、VS Code 等)的範例調整結構(如 `mcpServers` 與 `servers`)。同時確保 `args` 中的映像名稱與 `docker build` 使用的標籤一致。_-</details>-<details><summary><b>在 Windows 安裝</b></summary>-Windows 的設定與 Linux 或 macOS 略有不同(_範例以 Cline 為例_)。其他編輯器同理,請參考 `command` 與 `args` 設定。-```json{"mcpServers": {@@ -557,19 +436,14 @@ Windows 的設定與 Linux 或 macOS 略有不同(_範例以 Cline 為例_)}}```-</details>-<details><summary><b>在 Augment Code 安裝</b></summary>-在 Augment Code 設定 Context7 MCP,請依下列步驟:-1. 按 Cmd/Ctrl Shift P 或於 Augment 面板的漢堡選單中選擇2. 選擇 Edit Settings3. 於 Advanced 下點選 Edit in settings.json4. 將伺服器設定加入 `augment.advanced` 物件的 `mcpServers` 陣列-```json"augment.advanced": {"mcpServers": [@@ -581,18 +455,12 @@ 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": {@@ -603,9 +471,7 @@ Windows 的設定與 Linux 或 macOS 略有不同(_範例以 Cline 為例_)}}```-#### Roo Code 本地伺服器連線-```json{"mcpServers": {@@ -616,35 +482,25 @@ Windows 的設定與 Linux 或 macOS 略有不同(_範例以 Cline 為例_)}}```-</details>-<details><summary><b>在 Zencoder 安裝</b></summary>-要在 Zencoder 設定 Context7 MCP,請依照下列步驟操作:-1. 前往 Zencoder 選單(...)2. 從下拉選單選擇 Agent tools3. 點擊 Add custom MCP4. 輸入名稱與下方伺服器設定,並記得點擊 Install 按鈕-```json{"command": "npx","args": ["-y", "@upstash/context7-mcp@latest"]}```-新增 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{"mcpServers": {@@ -655,19 +511,14 @@ 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。3. 點擊 + Add new MCP。4. 加入以下設定:-```json{"mcpServers": {@@ -677,19 +528,14 @@ 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`3. 在對話框左上角點擊 `Command` 並選擇 As JSON4. 輸入以下設定並點擊 `OK`-```json{"mcpServers": {@@ -700,21 +546,15 @@ 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 伺服器3. 貼上以下設定:-```json{"Context7": {@@ -726,18 +566,12 @@ 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": {@@ -747,9 +581,7 @@ Windows 的設定與 Linux 或 macOS 略有不同(_範例以 Cline 為例_)}}```-#### Opencode 本地伺服器連線-```json{"mcp": {@@ -761,19 +593,13 @@ 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 伺服器。3. 貼上以下設定:-```json{"mcpServers": {@@ -787,48 +613,33 @@ 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. 貼上以下設定:-```json{"mcpServers": {@@ -839,41 +650,28 @@ http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }}}```-3. 點擊 `Save` 套用變更。4. 可於右側 `Program` 下方或聊天框底部的插頭圖示切換 MCP 伺服器開關。-</details>-## 🔨 可用工具-Context7 MCP 提供下列工具供 LLM 使用:-- `resolve-library-id`:將一般函式庫名稱解析為 Context7 相容的函式庫 ID。+ - `query`(必填):使用者的問題或任務(用於相關性排名)- `libraryName`(必填):要查詢的函式庫名稱--- `get-library-docs`:根據 Context7 相容的函式庫 ID 取得文件。- - `context7CompatibleLibraryID`(必填):Context7 相容的函式庫 ID(如 `/mongodb/docs`, `/vercel/next.js`)- - `topic`(選填):聚焦於特定主題(如 "routing", "hooks")- - `page`(選填,預設 1):分頁的頁碼(1-10)。如果上下文不足,請嘗試使用相同主題的 page=2、page=3 等。-+- `query-docs`:根據 Context7 相容的函式庫 ID 取得文件。+ - `libraryId`(必填):Context7 相容的函式庫 ID(如 `/mongodb/docs`, `/vercel/next.js`)+ - `query`(必填):用於取得相關文件的問題或任務## 💻 開發-複製專案並安裝依賴:-```bash-bun i+pnpm i```-建置:-```bash-bun run build+pnpm run build```-<details><summary><b>本地設定範例</b></summary>-```json{"mcpServers": {@@ -884,25 +682,17 @@ bun 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{"mcpServers": {@@ -913,16 +703,11 @@ 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{"mcpServers": {@@ -933,14 +718,10 @@ npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp}}```-</details>-<details><summary><b>TLS/憑證問題</b></summary>-可加上 `--experimental-fetch` 參數繞過 TLS 問題:-```json{"mcpServers": {@@ -951,33 +732,22 @@ 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)- [Income Stream Surfers:「Context7 + SequentialThinking MCPs:這是 AGI 嗎?」](https://www.youtube.com/watch?v=-ggvzyLpK6o)@@ -986,11 +756,7 @@ 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)-## 📄 授權-MITdiff --git a/packages/mcp/mcpb/context7.mcpb b/packages/mcp/mcpb/context7.mcpbindex caeed2b7..b34a3a4a 100644Binary files a/packages/mcp/mcpb/context7.mcpb and b/packages/mcp/mcpb/context7.mcpb differdiff --git a/packages/mcp/mcpb/manifest.json b/packages/mcp/mcpb/manifest.jsonindex 6020a31a..8901b065 100644--- a/packages/mcp/mcpb/manifest.json+++ b/packages/mcp/mcpb/manifest.json@@ -2,7 +2,7 @@"dxt_version": "0.1","name": "context7","display_name": "Context7",- "version": "1.0.1",+ "version": "2.0.0","description": "Up-to-date Code Docs For Any Prompt","long_description": "Context7 MCP pulls up-to-date, version-specific documentation and code examples straight from the source — and places them directly into your prompt.","author": {@@ -25,11 +25,11 @@"tools": [{"name": "Resolve Context7 Library ID",- "description": "Resolves a package/product name to a Context7-compatible library ID and returns a list of matching libraries."+ "description": "Resolves a package/product name to a Context7-compatible library ID and returns matching libraries."},{- "name": "Get Library Docs",- "description": "Fetches up-to-date documentation for a library."+ "name": "Query Documentation",+ "description": "Retrieves and queries up-to-date documentation and code examples from Context7."}],"compatibility": {diff --git a/packages/mcp/package.json b/packages/mcp/package.jsonindex 6a06c9d5..78e3859b 100644--- a/packages/mcp/package.json+++ b/packages/mcp/package.json@@ -1,6 +1,6 @@{"name": "@upstash/context7-mcp",- "version": "1.0.33",+ "version": "2.0.0","mcpName": "io.github.upstash/context7","description": "MCP server for Context7","scripts": {@@ -13,7 +13,7 @@"format:check": "prettier --check .","dev": "tsc --watch","start": "node dist/index.js --transport http",- "pack-mcpb": "pnpm install && pnpm run build && rm -rf node_modules && pnpm install --prod && mv mcpb/.mcpbignore .mcpbignore && mv mcpb/manifest.json manifest.json && mv public/icon.png icon.png && mcpb validate manifest.json && mcpb pack . mcpb/context7.mcpb && mv manifest.json mcpb/manifest.json && mv .mcpbignore mcpb/.mcpbignore && mv icon.png public/icon.png && bun install"+ "pack-mcpb": "pnpm install && pnpm run build && rm -rf node_modules && pnpm install --prod && cp mcpb/manifest.json manifest.json && cp ../../public/icon.png icon.png && mcpb validate manifest.json && mcpb pack . mcpb/context7.mcpb && rm manifest.json icon.png && pnpm install"},"repository": {"type": "git",diff --git a/packages/mcp/src/index.ts b/packages/mcp/src/index.tsindex 3c194a1c..14124299 100644--- a/packages/mcp/src/index.ts+++ b/packages/mcp/src/index.ts@@ -3,16 +3,13 @@import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";import { z } from "zod";-import { searchLibraries, fetchLibraryDocumentation } from "./lib/api.js";+import { searchLibraries, fetchLibraryContext } from "./lib/api.js";import { formatSearchResults } from "./lib/utils.js";-import { SearchResponse, DOCUMENTATION_MODES } from "./lib/types.js";import express from "express";import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";import { Command } from "commander";import { AsyncLocalStorage } from "async_hooks";-/** Default number of results to return per page */-const DEFAULT_RESULTS_LIMIT = 10;/** Default HTTP server port */const DEFAULT_PORT = 3000;@@ -101,7 +98,7 @@ function getClientIp(req: express.Request): string | undefined {const server = new McpServer({name: "Context7",- version: "1.0.13",+ version: "2.0.0",},{instructions:@@ -113,9 +110,9 @@ server.registerTool("resolve-library-id",{title: "Resolve Context7 Library ID",- description: `Resolves a package/product name to a Context7-compatible library ID and returns a list of matching libraries.+ description: `Resolves a package/product name to a Context7-compatible library ID and returns matching libraries.-You MUST call this function before 'get-library-docs' to obtain a valid Context7-compatible library ID UNLESS the user explicitly provides a library ID in the format '/org/project' or '/org/project/version' in their query.+You MUST call this function before 'query-docs' to obtain a valid Context7-compatible library ID UNLESS the user explicitly provides a library ID in the format '/org/project' or '/org/project/version' in their query.Selection Process:1. Analyze the query to understand what library/package the user is looking for@@ -132,21 +129,24 @@ Response Format:- If multiple good matches exist, acknowledge this but proceed with the most relevant one- If no good matches exist, clearly state this and suggest query refinements-For ambiguous queries, request clarification before proceeding with a best-guess match.`,+For ambiguous queries, request clarification before proceeding with a best-guess match.++IMPORTANT: Do not call this tool more than 3 times per question. If you cannot find what you need after 3 calls, use the best result you have.`,inputSchema: {+ query: z+ .string()+ .describe(+ "The user's original question or task. This is used to rank library results by relevance to what the user is trying to accomplish. IMPORTANT: Do not include any sensitive or confidential information such as API keys, passwords, credentials, or personal data in your query."+ ),libraryName: z.string().describe("Library name to search for and retrieve a Context7-compatible library ID."),},},- async ({ libraryName }) => {+ async ({ query, libraryName }) => {const ctx = requestContext.getStore();const apiKey = ctx?.apiKey || globalApiKey;- const searchResponse: SearchResponse = await searchLibraries(- libraryName,- ctx?.clientIp,- apiKey- );+ const searchResponse = await searchLibraries(query, libraryName, ctx?.clientIp, apiKey);if (!searchResponse.results || searchResponse.results.length === 0) {return {@@ -155,7 +155,7 @@ For ambiguous queries, request clarification before proceeding with a best-guesstype: "text",text: searchResponse.error? searchResponse.error- : "Failed to retrieve library documentation data from Context7",+ : "No libraries found matching the provided name.",},],};@@ -192,70 +192,38 @@ ${resultsText}`;);server.registerTool(- "get-library-docs",+ "query-docs",{- title: "Get Library Docs",- description:- "Fetches up-to-date documentation for a library. You must call 'resolve-library-id' first to obtain the exact Context7-compatible library ID required to use this tool, UNLESS the user explicitly provides a library ID in the format '/org/project' or '/org/project/version' in their query. Use mode='code' (default) for API references and code examples, or mode='info' for conceptual guides, narrative information, and architectural questions.",+ title: "Query Documentation",+ description: `Retrieves and queries up-to-date documentation and code examples from Context7 for any programming library or framework.++You must call 'resolve-library-id' first to obtain the exact Context7-compatible library ID required to use this tool, UNLESS the user explicitly provides a library ID in the format '/org/project' or '/org/project/version' in their query.++IMPORTANT: Do not call this tool more than 3 times per question. If you cannot find what you need after 3 calls, use the best information you have.`,inputSchema: {- context7CompatibleLibraryID: z+ libraryId: z.string().describe("Exact Context7-compatible library ID (e.g., '/mongodb/docs', '/vercel/next.js', '/supabase/supabase', '/vercel/next.js/v14.3.0-canary.87') retrieved from 'resolve-library-id' or directly from user query in the format '/org/project' or '/org/project/version'."),- mode: z- .enum(["code", "info"])- .optional()- .default("code")- .describe(- "Documentation mode: 'code' for API references and code examples (default), 'info' for conceptual guides, narrative information, and architectural questions."- ),- topic: z+ query: z.string()- .optional()- .describe("Topic to focus documentation on (e.g., 'hooks', 'routing')."),- page: z- .number()- .int()- .min(1)- .max(10)- .optional().describe(- "Page number for pagination (start: 1, default: 1). If the context is not sufficient, try page=2, page=3, page=4, etc. with the same topic."+ "The question or task you need help with. Be specific and include relevant details. Good: 'How to set up authentication with JWT in Express.js' or 'React useEffect cleanup function examples'. Bad: 'auth' or 'hooks'. IMPORTANT: Do not include any sensitive or confidential information such as API keys, passwords, credentials, or personal data in your query."),},},- async ({ context7CompatibleLibraryID, mode = DOCUMENTATION_MODES.CODE, page = 1, topic }) => {+ async ({ query, libraryId }) => {const ctx = requestContext.getStore();const apiKey = ctx?.apiKey || globalApiKey;- const fetchDocsResponse = await fetchLibraryDocumentation(- context7CompatibleLibraryID,- mode,- {- page,- limit: DEFAULT_RESULTS_LIMIT,- topic,- },- ctx?.clientIp,- apiKey- );-- if (!fetchDocsResponse) {- return {- content: [- {- type: "text",- text: "Documentation not found or not finalized for this library. This might have happened because you used an invalid Context7-compatible library ID. To get a valid Context7-compatible library ID, use the 'resolve-library-id' with the package name you wish to retrieve documentation for.",- },- ],- };- }++ const response = await fetchLibraryContext({ query, libraryId }, ctx?.clientIp, apiKey);return {content: [{type: "text",- text: fetchDocsResponse,+ text: response.data,},],};@@ -267,7 +235,6 @@ async function main() {if (transportType === "http") {const initialPort = CLI_PORT ?? DEFAULT_PORT;- let actualPort = initialPort;const app = express();app.use(express.json());@@ -307,12 +274,8 @@ async function main() {const extractApiKey = (req: express.Request): string | undefined => {return (extractBearerToken(req.headers.authorization) ||- extractHeaderValue(req.headers["Context7-API-Key"]) ||- extractHeaderValue(req.headers["X-API-Key"]) ||extractHeaderValue(req.headers["context7-api-key"]) ||extractHeaderValue(req.headers["x-api-key"]) ||- extractHeaderValue(req.headers["Context7_API_Key"]) ||- extractHeaderValue(req.headers["X_API_Key"]) ||extractHeaderValue(req.headers["context7_api_key"]) ||extractHeaderValue(req.headers["x_api_key"]));@@ -374,9 +337,8 @@ async function main() {});httpServer.once("listening", () => {- actualPort = port;console.error(- `Context7 Documentation MCP Server running on HTTP at http://localhost:${actualPort}/mcp`+ `Context7 Documentation MCP Server running on HTTP at http://localhost:${port}/mcp`);});};diff --git a/packages/mcp/src/lib/api.ts b/packages/mcp/src/lib/api.tsindex 05a75f89..830b1497 100644--- a/packages/mcp/src/lib/api.ts+++ b/packages/mcp/src/lib/api.ts@@ -1,37 +1,8 @@-import { SearchResponse } from "./types.js";+import { SearchResponse, ContextRequest, ContextResponse } from "./types.js";import { generateHeaders } from "./encryption.js";import { ProxyAgent, setGlobalDispatcher } from "undici";-import { DocumentationMode, DOCUMENTATION_MODES } from "./types.js";const CONTEXT7_API_BASE_URL = "https://context7.com/api";-const DEFAULT_TYPE = "txt";--/**- * Parses a Context7-compatible library ID into its components- * @param libraryId The library ID (e.g., "/vercel/next.js" or "/vercel/next.js/v14.3.0")- * @returns Object with username, library, and optional tag- */-function parseLibraryId(libraryId: string): {- username: string;- library: string;- tag?: string;-} {- // Remove leading slash if present- const cleaned = libraryId.startsWith("/") ? libraryId.slice(1) : libraryId;- const parts = cleaned.split("/");-- if (parts.length < 2) {- throw new Error(- `Invalid library ID format: ${libraryId}. Expected format: /username/library or /username/library/tag`- );- }-- return {- username: parts[0],- library: parts[1],- tag: parts[2], // undefined if not present- };-}/*** Parses error response from the Context7 API@@ -92,19 +63,22 @@ if (PROXY_URL && !PROXY_URL.startsWith("$") && /^(http|https):\/\//i.test(PROXY_/*** Searches for libraries matching the given query- * @param query The search query+ * @param query The user's question or task (used for LLM relevance ranking)+ * @param libraryName The library name to search for in the database* @param clientIp Optional client IP address to include in headers* @param apiKey Optional API key for authentication* @returns Search results or null if the request fails*/export async function searchLibraries(query: string,+ libraryName: string,clientIp?: string,apiKey?: string): Promise<SearchResponse> {try {- const url = new URL(`${CONTEXT7_API_BASE_URL}/v2/search`);+ const url = new URL(`${CONTEXT7_API_BASE_URL}/v2/libs/search`);url.searchParams.set("query", query);+ url.searchParams.set("libraryName", libraryName);const headers = generateHeaders(clientIp, apiKey);@@ -127,39 +101,21 @@ export async function searchLibraries(}/**- * Fetches documentation context for a specific library- * @param libraryId The library ID to fetch documentation for- * @param docMode Documentation mode (CODE for API references and code examples, INFO for conceptual guides)- * @param options Optional request parameters (page, limit, topic)+ * Fetches intelligent, reranked context for a natural language query+ * @param request The context request parameters (query, topic, library, mode)* @param clientIp Optional client IP address to include in headers* @param apiKey Optional API key for authentication- * @returns The documentation text or null if the request fails+ * @returns Context response with data*/-export async function fetchLibraryDocumentation(- libraryId: string,- docMode: DocumentationMode,- options: {- page?: number;- limit?: number;- topic?: string;- } = {},+export async function fetchLibraryContext(+ request: ContextRequest,clientIp?: string,apiKey?: string-): Promise<string | null> {+): Promise<ContextResponse> {try {- const { username, library, tag } = parseLibraryId(libraryId);-- // Build URL path- let urlPath = `${CONTEXT7_API_BASE_URL}/v2/docs/${docMode}/${username}/${library}`;- if (tag) {- urlPath += `/${tag}`;- }-- const url = new URL(urlPath);- url.searchParams.set("type", DEFAULT_TYPE);- if (options.topic) url.searchParams.set("topic", options.topic);- if (options.page) url.searchParams.set("page", options.page.toString());- if (options.limit) url.searchParams.set("limit", options.limit.toString());+ const url = new URL(`${CONTEXT7_API_BASE_URL}/v2/context`);+ url.searchParams.set("query", request.query);+ url.searchParams.set("libraryId", request.libraryId);const headers = generateHeaders(clientIp, apiKey, { "X-Context7-Source": "mcp-server" });@@ -167,20 +123,19 @@ export async function fetchLibraryDocumentation(if (!response.ok) {const errorMessage = await parseErrorResponse(response, apiKey);console.error(errorMessage);- return errorMessage;+ return { data: errorMessage };}+const text = await response.text();- if (!text || text === "No content available" || text === "No context data available") {- const suggestion =- docMode === DOCUMENTATION_MODES.CODE- ? " Try mode='info' for guides and tutorials."- : " Try mode='code' for API references and code examples.";- return `No ${docMode} documentation available for this library.${suggestion}`;+ if (!text) {+ return {+ data: "Documentation not found or not finalized for this library. This might have happened because you used an invalid Context7-compatible library ID. To get a valid Context7-compatible library ID, use the 'resolve-library-id' with the package name you wish to retrieve documentation for.",+ };}- return text;+ return { data: text };} catch (error) {- const errorMessage = `Error fetching library documentation. Please try again later. ${error}`;+ const errorMessage = `Error fetching library context. Please try again later. ${error}`;console.error(errorMessage);- return errorMessage;+ return { data: errorMessage };}}diff --git a/packages/mcp/src/lib/types.ts b/packages/mcp/src/lib/types.tsindex 89afe11c..cf492656 100644--- a/packages/mcp/src/lib/types.ts+++ b/packages/mcp/src/lib/types.ts@@ -21,12 +21,11 @@ export interface SearchResponse {// Version state is still needed for validating search resultsexport type DocumentState = "initial" | "finalized" | "error" | "delete";-/**- * Documentation modes for fetching library documentation- */-export const DOCUMENTATION_MODES = {- CODE: "code",- INFO: "info",-} as const;+export type ContextRequest = {+ query: string;+ libraryId: string;+};-export type DocumentationMode = (typeof DOCUMENTATION_MODES)[keyof typeof DOCUMENTATION_MODES];+export type ContextResponse = {+ data: string;+};