Context7 MCP: Актуальная документация кода для LLM и AI-редакторов
Проблема устаревшей информации
При работе с языковыми моделями (LLM) в процессе разработки разработчики сталкиваются с серьезными проблемами:
❌ Примеры кода устарели — основаны на данных годичной давности из обучающей выборки ❌ Галлюцинации API — модели придумывают несуществующие методы и функции ❌ Общие ответы — решения для старых версий библиотек, которые больше не работают
Решение: Context7
Context7 — это MCP-сервер (Model Context Protocol), который извлекает актуальную документацию для конкретной версии библиотеки прямо из первоисточника и помещает её непосредственно в контекст вашего промпта.
Как это работает
Всё очень просто:
- Пишете промпт как обычно
- Добавляете use context7 в текст запроса
- Получаете работающий код с актуальными API
Пример использования в Cursor:
Создай middleware для Next.js, который проверяет валидный JWT в cookies и перенаправляет неавторизованных пользователей на `/login`. use context7
Или:
Настрой скрипт Cloudflare Worker для кеширования JSON API-ответов на пять минут. use context7
Context7 автоматически получает актуальные примеры кода и документацию. Никаких переключений между вкладками, никаких выдуманных API, никакой генерации устаревшего кода.
Поддерживаемые редакторы и IDE
Context7 работает с множеством популярных инструментов:
- Cursor — рекомендуемый редактор с одной кнопкой установки
- Claude Code — родная интеграция с Claude
- VS Code — через Model Context Protocol
- Windsurf — полная поддержка MCP
- JetBrains (IntelliJ, PyCharm и др.) — через AI Assistant
- Cline — установка через маркетплейс
- Zed — через расширения
- Claude Desktop — локальное подключение
- И многие другие: Augment Code, Roo Code, Gemini CLI, Copilot Coding Agent, LM Studio, Visual Studio 2022, Perplexity Desktop
Установка
Быстрая установка через Smithery
npx -y @smithery/cli@latest install @upstash/context7-mcp --client <ИМЯ_КЛИЕНТА> --key <ВАШ_КЛЮЧ>
Установка в Cursor
Перейдите в: Settings → Cursor Settings → MCP → Add new global MCP server
Удалённое подключение:
{
"mcpServers": {
"context7": {
"url": "https://mcp.context7.com/mcp",
"headers": {
"CONTEXT7_API_KEY": "ВАШ_API_КЛЮЧ"
}
}
}
}
Локальное подключение:
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp", "--api-key", "ВАШ_API_КЛЮЧ"]
}
}
}
Получение API-ключа
API-ключ не обязателен, но рекомендуется для снятия лимитов по количеству запросов. Получить его можно, создав аккаунт на context7.com/dashboard.
Доступные инструменты
Context7 MCP предоставляет два основных инструмента:
1. resolve-library-id
Преобразует общее название библиотеки в совместимый с Context7 идентификатор.
Параметры:
- libraryName (обязательный) — название библиотеки для поиска
2. get-library-docs
Получает документацию для библиотеки по её идентификатору.
Параметры:
- context7CompatibleLibraryID (обязательный) — точный идентификатор (например, /mongodb/docs, /vercel/next.js)
- topic (опциональный) — фокус на конкретной теме (например, "routing", "hooks")
- tokens (опциональный, по умолчанию 5000) — максимальное количество токенов в ответе
Полезные советы
Автоматическое использование через правила
Чтобы не добавлять use context7 к каждому промпту, создайте правило в настройках редактора:
Пример правила:
Всегда используй context7, когда мне нужна генерация кода, шаги по настройке или документация библиотек/API. Это означает, что ты должен автоматически использовать инструменты Context7 MCP для определения ID библиотеки и получения документации, без необходимости явного запроса с моей стороны.
Прямое указание ID библиотеки
Если вы точно знаете, какую библиотеку хотите использовать, укажите её Context7 ID прямо в промпте:
Реализуй базовую аутентификацию с Supabase. use library /supabase/supabase для API и документации.
Это позволит Context7 пропустить этап поиска библиотеки и сразу загрузить документацию.
Дополнительные возможности
- Поддержка альтернативных runtime: Bun, Deno
- Docker-контейнеры для изолированного запуска
- HTTP Proxy поддержка через переменные окружения
- Кросс-платформенность: работает на Windows, macOS, Linux
Требования
- Node.js версии 18.0.0 или выше
- MCP-клиент (Cursor, Claude Code, VS Code и т.д.)
- Context7 API Key (опционально, для повышенных лимитов)
Добавление проектов
Context7 — это community-driven платформа. Вы можете добавить свою любимую библиотеку или обновить существующую документацию. Ознакомьтесь с руководством по добавлению проектов в репозитории.
Заключение
Context7 решает фундаментальную проблему AI-ассистированной разработки — устаревание информации в обучающей выборке модели. Вместо того чтобы полагаться на знания модели годичной давности, Context7 предоставляет актуальную, проверенную документацию из первоисточников в реальном времени.
С поддержкой более 20 редакторов и IDE, простой установкой и бесплатным использованием (с опциональным API-ключом для расширенных возможностей), Context7 становится незаменимым инструментом для современной разработки с использованием AI.
Полезные ссылки:
- 🌐 Официальный сайт: context7.com
- 📦 GitHub: github.com/upstash/context7
- 💬 Discord-сообщество для поддержки
- 📢 Twitter/X для новостей и обновлений
Популярность проекта: 32k+ звёзд на GitHub, 1.6k форков, активное сообщество из 73 контрибьюторов.
Проект разработан командой Upstash и распространяется под лицензией MIT.