mirror of https://github.com/upstash/context7.git synced 2025-11-25 14:37:27 +00:00

ruslanlap 8803bd2545 fix: badge to end

2025-07-10 20:08:47 +03:00

33 KiB

Raw Blame History

Context7 MCP — Актуальна документація з прикладами коду для будь-якого запиту

❌ Без Context7

Великі мовні моделі покладаються на застарілу або узагальнену інформацію про бібліотеки, які ви використовуєте. Внаслідок цього ви отримуєте:

❌ Застарілі приклади коду, що базуються на даних навчання кількарічної давності
❌ «Галюцинації» — API, які взагалі не існують
❌ Узагальнені відповіді для старих версій пакунків

✅ З Context7

Context7 MCP отримує актуальну, специфічну для версії документацію та приклади коду безпосередньо з джерела — і вбудовує їх прямо у ваш промпт.

Додайте use context7 до вашого запиту в Cursor:

Create a Next.js middleware that checks for a valid JWT in cookies and redirects unauthenticated users to `/login`. use context7

Configure a Cloudflare Worker script to cache JSON API responses for five minutes. use context7

Context7 завантажує свіжі приклади коду й документацію безпосередньо в контекст вашої великої мовної моделі.

1️⃣ Написуйте ваш промпт природно
2️⃣ Скажіть ШІ використати use context7
3️⃣ Отримайте робочі відповіді з кодом

Без перемикання між вкладками, без неіснуючих API та без застарілого коду.

📚 Додавання проєктів

Ознайомтеся з нашим посібником з додавання проєктів, щоб дізнатися, як додати (або оновити) ваші улюблені бібліотеки в Context7.

🛠️ Встановлення

Системні вимоги

Node.js ≥ v18.0.0
Cursor, Windsurf, Claude Desktop або інший MCP-клієнт

Встановлення через Smithery

Для автоматичного встановлення Context7 MCP Server для будь-якого клієнта через Smithery:

npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME> --key <YOUR_SMITHERY_KEY>

Ваш ключ Smithery можна знайти на сторінці Smithery.ai.

Встановлення в Cursor

Перейдіть до: Settings → Cursor Settings → MCP → Add new global MCP server

Рекомендується вставити наступну конфігурацію у файл ~/.cursor/mcp.json. Також можна встановити для конкретного проєкту, створивши .cursor/mcp.json у теці проєкту. Детальніше див. у документації Cursor MCP.

Починаючи з Cursor 1.0, ви можете просто натиснути кнопку встановлення нижче для миттєвої інсталяції.

Підключення до віддаленого сервера Cursor

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

Підключення до локального сервера Cursor

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

Альтернатива: використання Bun

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

Альтернатива: використання Deno

{
  "mcpServers": {
    "context7": {
      "command": "deno",
      "args": ["run", "--allow-env=NO_DEPRECATION,TRACE_DEPRECATION", "--allow-net", "npm:@upstash/context7-mcp"]
    }
  }
}

Встановлення в Windsurf

Додайте це до вашого конфігураційного файлу Windsurf MCP. Детальніше див. у документації Windsurf MCP.

Підключення до віддаленого сервера Windsurf

{
  "mcpServers": {
    "context7": {
      "serverUrl": "https://mcp.context7.com/sse"
    }
  }
}

Підключення до локального сервера Windsurf

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

Встановлення в Trae

Використовуйте функцію "Add manually" і заповніть конфігурацію JSON для цього MCP-сервера. Детальніше див. у документації Trae.

Підключення до віддаленого сервера Trae

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

Підключення до локального сервера Trae

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

Встановлення в VS Code

Додайте це до вашого конфігураційного файлу VS Code MCP. Детальніше див. у документації VS Code MCP.

Підключення до віддаленого сервера VS Code

"mcp": {
  "servers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

Підключення до локального сервера VS Code

"mcp": {
  "servers": {
    "context7": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

Встановлення в Visual Studio 2022

Ви можете налаштувати Context7 MCP у Visual Studio 2022, дотримуючись документації Visual Studio MCP Servers.

Додайте це до вашого конфігураційного файлу Visual Studio MCP (детальніше в документації Visual Studio):

{
  "mcp": {
    "servers": {
      "context7": {
        "type": "http",
        "url": "https://mcp.context7.com/mcp"
      }
    }
  }
}

Або для локального сервера:

{
  "mcp": {
    "servers": {
      "context7": {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "@upstash/context7-mcp"]
      }
    }
  }
}

Встановлення в Zed

Можна встановити через розширення Zed або додати це до вашого settings.json. Детальніше див. у документації Zed Context Server.

{
  "context_servers": {
    "Context7": {
      "command": {
        "path": "npx",
        "args": ["-y", "@upstash/context7-mcp"]
      },
      "settings": {}
    }
  }
}

Встановлення в Gemini CLI

Детальніше див. у конфігурації Gemini CLI.

Відкрийте файл налаштувань Gemini CLI. Розташування: ~/.gemini/settings.json (де ~ — ваша домашня тека).
Додайте наступне до об'єкта mcpServers у вашому settings.json:

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

Якщо об'єкт mcpServers не існує, створіть його.

Встановлення в Claude Code

Виконайте цю команду. Детальніше див. у документації Claude Code MCP.

Підключення до віддаленого сервера Claude Code

claude mcp add --transport http context7 https://mcp.context7.com/mcp

Або з використанням SSE-транспорту:

claude mcp add --transport sse context7 https://mcp.context7.com/sse

Підключення до локального сервера Claude Code

claude mcp add context7 -- npx -y @upstash/context7-mcp

Встановлення в Claude Desktop

Додайте це до вашого файлу claude_desktop_config.json у Claude Desktop. Детальніше див. у документації Claude Desktop MCP.

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

Встановлення в Cline

Ви можете легко встановити Context7 через торговий майданчик MCP-серверів Cline, дотримуючись цих інструкцій:

Відкрийте Cline.
Натисніть значок меню гамбургер (☰), щоб увійти до розділу MCP Servers.
Використовуйте панель пошуку у вкладці Marketplace, щоб знайти Context7.
Натисніть кнопку Install.

Встановлення в BoltAI

Відкрийте сторінку "Settings" застосунку, перейдіть до "Plugins" і введіть наступний JSON:

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

Після збереження введіть у чаті get-library-docs, а потім ваш ідентифікатор документації Context7 (наприклад, get-library-docs /nuxt/ui). Додаткова інформація доступна на сайті документації BoltAI. Для BoltAI на iOS див. цей посібник.

Використання Docker

Якщо ви віддаєте перевагу запуску MCP-сервера в Docker-контейнері:

Створіть Docker-образ:

Спочатку створіть Dockerfile у корені проєкту (або де завгодно):
Натисніть, щоб побачити вміст Dockerfile
```
FROM node:18-alpine

WORKDIR /app

# Встановіть найновішу версію глобально
RUN npm install -g @upstash/context7-mcp

# Відкрийте стандартний порт, якщо потрібно (необов'язково, залежить від взаємодії з MCP-клієнтом)
# EXPOSE 3000

# Стандартна команда для запуску сервера
CMD ["context7-mcp"]
```
Потім створіть образ, використовуючи тег (наприклад, context7-mcp). Переконайтеся, що Docker Desktop (або демон Docker) запущений. Виконайте наступну команду в тій же теці, де ви зберегли Dockerfile:
```
docker build -t context7-mcp .
```
Налаштуйте ваш MCP-клієнт:

Оновіть конфігурацію вашого MCP-клієнта для використання Docker-команди.

Приклад для cline_mcp_settings.json:
```
{
  "mcpServers": {
    "Context7": {
      "autoApprove": [],
      "disabled": false,
      "timeout": 60,
      "command": "docker",
      "args": ["run", "-i", "--rm", "context7-mcp"],
      "transportType": "stdio"
    }
  }
}
```
Примітка: Це приклад конфігурації. Будь ласка, зверніться до конкретних прикладів для вашого MCP-клієнта (наприклад, Cursor, VS Code тощо) раніше в цьому README, щоб адаптувати структуру (наприклад, mcpServers проти servers). Також переконайтеся, що назва образу в args збігається з тегом, використаним під час команди docker build.

Встановлення в Windows

Конфігурація в Windows дещо відрізняється від Linux або macOS (у прикладі використовується Cline). Той же принцип застосовується до інших редакторів; зверніться до конфігурації command та args.

{
  "mcpServers": {
    "github.com/upstash/context7-mcp": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@upstash/context7-mcp@latest"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Встановлення в Augment Code

Для налаштування Context7 MCP в Augment Code ви можете використовувати або графічний інтерфейс, або ручну конфігурацію.

A. Використання інтерфейсу Augment Code

Натисніть меню гамбургер.
Виберіть Settings.
Перейдіть до розділу Tools.
Натисніть кнопку + Add MCP.
Введіть наступну команду:
```
npx -y @upstash/context7-mcp@latest
```
Назва MCP: Context7.
Натисніть кнопку Add.

B. Ручна конфігурація

Натисніть Cmd/Ctrl Shift P або перейдіть до меню гамбургер у панелі Augment
Виберіть Edit Settings
У розділі Advanced натисніть Edit in settings.json
Додайте конфігурацію сервера до масиву mcpServers в об'єкті augment.advanced

"augment.advanced": {
  "mcpServers": [
    {
      "name": "context7",
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  ]
}

Встановлення в Roo Code

Додайте це до вашого конфігураційного файлу Roo Code MCP. Детальніше див. у документації Roo Code MCP.

Підключення до віддаленого сервера Roo Code

{
  "mcpServers": {
    "context7": {
      "type": "streamable-http",
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

Підключення до локального сервера Roo Code

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

Встановлення в Zencoder

Для налаштування Context7 MCP в Zencoder виконайте наступні кроки:

Перейдіть до меню Zencoder (...)
З випадного меню виберіть Agent tools
Натисніть на Add custom MCP
Додайте назву та конфігурацію сервера знизу і обов'язково натисніть кнопку Install

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

Встановлення в Amazon Q Developer CLI

Додайте це до вашого конфігураційного файлу Amazon Q Developer CLI. Детальніше див. у документації Amazon Q Developer CLI.

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

Встановлення в Qodo Gen

Детальніше див. у документації Qodo Gen.

Відкрийте панель чату Qodo Gen у VSCode або IntelliJ.
Натисніть Connect more tools.
Натисніть + Add new MCP.
Додайте наступну конфігурацію:

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

Встановлення в JetBrains AI Assistant

Детальніше див. у документації JetBrains AI Assistant.

У JetBrains IDE перейдіть до Settings → Tools → AI Assistant → Model Context Protocol (MCP)
Натисніть + Add.
Натисніть на Command у верхньому лівому куті діалогу та виберіть опцію As JSON зі списку
Додайте цю конфігурацію та натисніть OK

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

Натисніть Apply, щоб зберегти зміни.

Встановлення в Warp

Детальніше див. у документації Warp Model Context Protocol.

Перейдіть до Settings > AI > Manage MCP servers.
Додайте новий MCP-сервер, натиснувши кнопку + Add.
Вставте конфігурацію, наведену нижче:

{
  "Context7": {
    "command": "npx",
    "args": [
      "-y",
      "@upstash/context7-mcp"
    ],
    "env": {},
    "working_directory": null,
    "start_on_launch": true
  }
}

Натисніть Save, щоб застосувати зміни.

Встановлення в Opencode

Додайте це до вашого конфігураційного файлу Opencode. Детальніше див. у документації Opencode MCP.

Підключення до віддаленого сервера Opencode

"mcp": {
  "context7": {
    "type": "remote",
    "url": "https://mcp.context7.com/mcp",
    "enabled": true
  }
}

Підключення до локального сервера Opencode

{
  "mcp": {
    "context7": {
      "type": "local",
      "command": ["npx", "-y", "@upstash/context7-mcp"],
      "enabled": true
    }
  }
}

🔨 Доступні інструменти

Context7 MCP надає наступні інструменти, які можуть використовувати великі мовні моделі:

resolve-library-id: Перетворює загальну назву бібліотеки на сумісний з Context7 ідентифікатор бібліотеки.
- libraryName (обов'язково): Назва бібліотеки для пошуку
get-library-docs: Отримує документацію для бібліотеки, використовуючи сумісний з Context7 ідентифікатор бібліотеки.
- context7CompatibleLibraryID (обов'язково): Точний сумісний з Context7 ідентифікатор бібліотеки (наприклад, /mongodb/docs, /vercel/next.js)
- topic (необов'язково): Сфокусувати документацію на конкретній темі (наприклад, "routing", "hooks")
- tokens (необов'язково, за замовчуванням 10000): Максимальна кількість токенів для повернення. Значення менші за стандартне значення 10000 автоматично збільшуються до 10000.

🛟 Поради

Додайте правило

Якщо ви не хочете додавати use context7 до кожного промпту, ви можете визначити просте правило у вашому файлі .windsurfrules в Windsurf або в розділі Cursor Settings > Rules в Cursor (або еквівалентному у вашому MCP-клієнті), щоб автоматично викликати Context7 для будь-яких запитань про код:
[[calls]]
match = "when the user requests code examples, setup or configuration steps, or library/API documentation"
tool  = "context7"
Відтоді ви отримуватимете документацію Context7 у будь-якій пов'язаній розмові без введення будь-чого додаткового. Ви можете додати свої випадки використання до частини match.

Використовуйте ідентифікатор бібліотеки

Якщо ви вже точно знаєте, яку бібліотеку хочете використовувати, додайте її ідентифікатор Context7 до вашого промпту. Таким чином Context7 MCP-сервер може пропустити крок пошуку бібліотеки та одразу перейти до отримання документації.
implement basic authentication with supabase. use library /supabase/supabase for api and docs
Синтаксис із слешем повідомляє MCP-інструменту точно, для якої бібліотеки завантажувати документацію.

💻 Розробка

Склонуйте проєкт і встановіть залежності:

bun i

Збирання:

bun run build

Запуск сервера:

bun run dist/index.js

Аргументи командного рядка

context7-mcp приймає наступні прапори CLI:

--transport <stdio|http|sse> — Транспорт для використання (stdio за замовчуванням).
--port <number> — Порт для прослуховування при використанні транспорту http або sse (за замовчуванням 3000).

Приклад з http-транспортом і портом 8080:

bun run dist/index.js --transport http --port 8080

Приклад локальної конфігурації

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["tsx", "/path/to/folder/context7-mcp/src/index.ts"]
    }
  }
}

Тестування з MCP Inspector

npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp

🚨 Усунення несправностей

Помилки "Module Not Found"

Якщо ви стикаєтеся з ERR_MODULE_NOT_FOUND, спробуйте використовувати bunx замість npx:

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

Це часто вирішує проблеми розв'язання модулів у середовищах, де npx не встановлює або не розв'язує пакунки належним чином.

Проблеми розв'язання ESM

Для помилок типу Error: Cannot find module 'uriTemplate.js' спробуйте прапор --experimental-vm-modules:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "--node-options=--experimental-vm-modules", "@upstash/context7-mcp@1.0.6"]
    }
  }
}

Проблеми TLS/сертифікатів

Використовуйте прапор --experimental-fetch, щоб обійти проблеми, пов'язані з TLS:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "--node-options=--experimental-fetch", "@upstash/context7-mcp"]
    }
  }
}

Загальні помилки MCP-клієнта

Спробуйте додати @latest до назви пакунка
Використовуйте bunx як альтернативу до npx
Розгляньте використання deno як іншу альтернативу
Переконайтеся, що ви використовуєте Node.js v18 або вище для підтримки нативного fetch

⚠️ Застереження

Проєкти Context7 створюються спільнотою, і хоча ми прагнемо підтримувати високу якість, ми не можемо гарантувати точність, повноту або безпеку всієї документації бібліотек. Проєкти, перелічені в Context7, розробляються та підтримуються їхніми відповідними власниками, а не Context7. Якщо ви зіткнетеся з будь-яким підозрілим, неприйнятним або потенційно шкідливим контентом, будь ласка, використовуйте кнопку "Report" на сторінці проєкту, щоб негайно повідомити нас. Ми серйозно ставимося до всіх звітів і оперативно переглядаємо позначений контент для підтримання цілісності та безпеки нашої платформи. Використовуючи Context7, ви визнаєте, що робите це на власний розсуд і ризик.

🤝 Зв'яжіться з нами

Залишайтеся в курсі подій та приєднуйтеся до нашої спільноти:

📢 Слідкуйте за нами в X для отримання останніх новин та оновлень
🌐 Відвідайте наш веб-сайт
💬 Приєднуйтеся до нашої спільноти Discord

📺 Context7 у медіа

⭐ Історія зірок

📄 Ліцензія

MIT

33 KiB Raw Blame History Unescape Escape