AIKraft Agents

upstash/context7-mcp

Платформа Context7 — актуальная документация по коду для LLM и AI-редакторов

MCP⭐ 64 254TypeScriptпоследний релиз: @upstash/context7-mcp@4.5.0
Открыть на GitHub ↗Сайт проекта ↗

Что это за инструмент

Context7 — это MCP-сервер и CLI-инструмент от Upstash, который предоставляет LLM актуальную документацию и примеры кода для библиотек в реальном времени.

Зачем нужен

Инструмент решает проблему устаревших знаний LLM и галлюцинаций с несуществующими API, подтягивая свежую документацию прямо в контекст промпта. Это позволяет агентам генерировать корректный код для конкретных версий библиотек без необходимости переключаться между вкладками браузера.

Что можно реализовать

  • Генерация middleware для Next.js с учетом актуальных версий и API
  • Настройка Cloudflare Workers для кэширования JSON-ответов
  • Использование API аутентификации Supabase для email/password
  • Получение специфичных примеров кода для известных библиотек по их ID
  • Автоматическое подтягивание документации при запросах о настройке конфигураций

Ключевые возможности

  • Интеграция через MCP-сервер или CLI-скиллы для агентов (Cursor, Claude Code и др.)
  • Поддержка точного указания версии библиотеки для получения релевантной документации
  • Возможность использования slash-синтаксиса (например, /supabase/supabase) для быстрого выбора библиотеки
  • Автоматическая аутентификация и установка через команду npx ctx7 setup
  • Поддержка мультиязычной документации (включая русский язык)

👤 Кому подойдёт: разработчики, использующие LLM-агентов и AI-редакторы кода

Релизы

@upstash/context7-mcp@4.5.0minor
🕐 3 дн назад · релиз на GitHub ↗

Исследовательская версия для обратной связи по документации и исправления обработки API-ключей в stdio.

  • Added: Добавлен инструмент submit-docs-feedback для оценки качества документации (активируется флагом --research-preview).
  • Fixed: Исправлена ошибка 401 при передаче незаполненных переменных окружения как API-ключа в stdio-режиме.
  • Fixed: Теперь API-ключи автоматически обрезаются от пробелов по краям.
  • Added: В телеметрию аутентификации MCP добавлена запись о типе использования Client ID.
@upstash/context7-sdk@0.6.0minor
🕐 13 дн назад · релиз на GitHub ↗

В методе search() поле rank теперь типизировано для всех сниппетов, упорядочивая их по рангу.

  • Added: Поле rank в результатах JSON теперь строго типизировано для каждого сниппета кода и информации.
  • Added: Значение rank указывает на позицию сниппета (начиная с 1) в общем отранжированном списке.
  • Fixed: Рекомендуется сортировать codeSnippets и infoSnippets совместно по полю rank для согласованного порядка.
@upstash/context7-mcp@4.4.4patch
🕐 17 дн назад · релиз на GitHub ↗

Исправлена валидация порта, улучшены инструкции для агентов и обработка несовместимых флагов.

  • Fixed: Флаги --port и --api-key теперь корректно отклоняются при использовании несовместимых транспортов.
  • Fixed: Порт проверяется на целочисленность в диапазоне 0–65535, а повторные попытки при занятом порте корректно останавливаются на 65535.
  • Added: Уточнены инструкции и шаблоны правил, чтобы агенты активнее использовали Context7 при портировании кода.
@upstash/context7-mcp@4.4.3patch
🕐 18 дн назад · релиз на GitHub ↗

Обновлён MCP SDK с ленивой инициализацией схем, добавлено кэширование списков ресурсов и улучшена обработка завершения работы сервера.

  • Added: Обновлён MCP SDK до версий 2.3.1 и 2.1.1, что обеспечивает ленивую конвертацию схем инструментов и снижает затраты на создание сервера для каждого запроса.
  • Added: Эндпоинты list и discover теперь возвращают TTL 1 час с публичным кэшированием, позволяя клиентам переиспользовать данные вместо повторных запросов.
  • Fixed: resolve-library-id корректно устанавливает isError: true при ошибке поиска библиотеки, тогда как отсутствие результатов остаётся нормальным состоянием.
  • Fixed: Улучшена обработка SIGTERM: HTTP-сервер теперь корректно завершает открытые соединения перед остановкой, избегая ошибок 499/500 и аварийного выхода.
  • Fixed: Отклонения некорректных запросов от клиента теперь логируются одной строкой без вывода стека вызовов.
ctx7@0.8.0minorbreaking
🕐 20 дн назад · релиз на GitHub ↗

Удалены устаревшие команды skills и generate из ctx7, setup сохраняет навыки.

  • Breaking: Удалены устаревшие команды skills и generate из ctx7.
  • Fixed: Команда ctx7 setup по-прежнему устанавливает навыки find-docs и context7-mcp.
@upstash/context7-mcp@4.4.2patch
🕐 21 дн назад · релиз на GitHub ↗

Обновлён протокол MCP: добавлены заголовок сервера и масштабируемые иконки (SVG, PNG 512x512) для улучшения отображения.

  • Added: В handshake и карточку сервера добавлены заголовок и масштабируемые иконки (SVG и PNG 512x512).
@upstash/context7-mcp@4.4.1patch
🕐 23 дн назад · релиз на GitHub ↗

Исправлена обработка отмен запросов в JSON-RPC батчах для корректной работы с legacy HTTP-транспортом.

  • Fixed: Исправлена проблема с открытым потоком ответов при отмене запросов в JSON-RPC батчах.
  • Fixed: Улучшена обработка пар запрос/отмена для legacy stateless HTTP транспорта.
@upstash/context7-mcp@4.3.0minor
🕐 27 дн назад · релиз на GitHub ↗

В функцию query-docs добавлен необязательный аргумент language для приоритизации примеров кода на нужном языке.

  • Added: В функцию query-docs добавлен необязательный аргумент language.
  • Added: Теперь Context7 ранжирует примеры кода на языке, который знает агент о пользователе, на первое место.
@upstash/context7-sdk@0.5.1patch
🕐 27 дн назад · релиз на GitHub ↗

Исправлена обработка таймаутов и отмены запросов при асинхронной аутентификации токенов.

  • Fixed: Учтены таймауты запросов и отмена операций во время ожидания токена аутентификации от асинхронного провайдера.
ctx7@0.5.15patch
🕐 28 дн назад · релиз на GitHub ↗

Команда ctx7 setup теперь загружает навыки find-docs и context7-mcp напрямую с GitHub, минуя устаревший Skill Hub API.

  • Fixed: Команда ctx7 setup больше не использует устаревший Skill Hub API.
  • Added: Навыки find-docs и context7-mcp теперь загружаются напрямую из репозитория GitHub.
@upstash/context7-mcp@4.2.0minorbreaking
🕐 29 дн назад · релиз на GitHub ↗

Обязательная аутентификация для HTTP-эндпоинта /mcp и проверка OAuth-токенов перед выполнением запросов.

  • Breaking: По умолчанию для HTTP-эндпоинта /mcp теперь требуется аутентификация; для сохранения анонимного доступа используйте переменную MCP_AUTH_ENFORCEMENT=observe.
  • Added: Сервер проверяет OAuth-токены через Context7 API перед выполнением запросов, кэшируя результат на одну минуту.
  • Fixed: При использовании просроченных или отозванных OAuth-токенов сервер возвращает HTTP 401 с вызовом на обновление токена, а не ошибку инструмента.
  • Added: Текст ошибки при отказе Context7 API теперь указывает на истечение срока действия сессии, а не на проблемы с API-ключами.
@upstash/context7-mcp@4.1.3patch
🕐 29 дн назад · релиз на GitHub ↗

Исправлена логика обработки подписок по HTTP и обновлена библиотека undici до версии 7.30.

  • Fixed: По HTTP запросы subscriptions/listen теперь корректно завершаются подтверждением и результатом complete, вместо ошибки о превышении лимита.
  • Fixed: Удалено логирование отказов в подписках, так как Context7 не поддерживает уведомления об изменениях и поток закрывается мгновенно.
  • Deprecated: Удалена настройка MCP_MAX_SUBSCRIPTIONS, так как она больше не используется.
  • Fixed: Обновлена зависимость undici до версии 7.30.
ctx7@0.5.13patch
🕐 1 мес назад · релиз на GitHub ↗

Исправлена обработка завершающих запятых в JSONC-конфигурациях OpenCode при настройке и удалении.

  • Fixed: Добавлена поддержка завершающих запятых в JSONC-конфигурациях OpenCode во время установки и удаления.
@upstash/context7-opencode@0.2.0minor
🕐 1 мес назад · релиз на GitHub ↗

Добавлена поддержка OpenCode v2 через новый entrypoint setup.

  • Added: Плагин теперь поддерживает OpenCode v2, экспортируя entrypoint setup.
  • Added: Команда opencode plugin add регистрирует Context7 MCP server и навык context7-mcp для версии 2.
@upstash/context7-sdk@0.5.0minor
🕐 1 мес назад · релиз на GitHub ↗

В версии 0.5.0 SDK добавлен типизированный метод search для поиска документации без дополнительных запросов.

  • Added: Добавлен типизированный метод search, позволяющий находить релевантную документацию без отдельного запроса на разрешение библиотеки.
@upstash/context7-mcp@4.1.1patch
🕐 1 мес назад · релиз на GitHub ↗

Исправление: отключены неиспользуемые подписки на уведомления MCP для оптимизации SSE-соединений.

  • Fixed: Отключены неиспользуемые подписки на уведомления MCP, чтобы клиенты не удерживали открытыми SSE-потоки для статических коллекций инструментов, промптов и ресурсов.
@upstash/context7-mcp@4.1.0minor
🕐 1 мес назад · релиз на GitHub ↗

Добавлены ограниченные метрики OpenTelemetry для MCP-запросов, инструментов и API-вызовов, доступные для Prometheus.

  • Added: Внедрены метрики OpenTelemetry для отслеживания MCP-запросов, вызовов инструментов, аутентификации и запросов к внешним API.
  • Added: Метрики экспортируются на внутренний порт HTTP-сервера для интеграции с Prometheus.
@upstash/context7-mcp@4.0.7patch
🕐 1 мес назад · релиз на GitHub ↗

Обновление @upstash/context7-mcp: разрешён анонимный доступ для плагина Claude Code при отсутствии API-ключа.

  • Added: Разрешён анонимный доступ для плагина Claude Code, если заголовок с API-ключом пуст.
ctx7@0.5.11minor
🕐 1 мес назад · релиз на GitHub ↗

Добавлена поддержка автономной установки MCP на стороне сервера через ctx7 setup --base-url с безопасным вводом ключа.

  • Added: Реализована независимая от исходящих соединений установка MCP на стороне сервера (on-premise) с использованием флага --base-url.
  • Added: Внедрена безопасная интерактивная процедура ввода личного API-ключа при настройке.
  • Added: Добавлена поддержка обнаружения сервисов через анонимную аутентификацию (anonymous-auth).
@upstash/context7-sdk@0.4.0minorbreaking
🕐 2 мес назад · релиз на GitHub ↗

Исправлен вывод типов, добавлены HTTP-контроли (таймауты, кэш, ретраи) и улучшена обработка ошибок.

  • Fixed: Исправлен вывод типов для форматов, выбираемых во время выполнения: теперь возвращается объединение array-or-string, требующее сужения типа.
  • Added: Добавлены производственные HTTP-контроли: таймауты (30 сек по умолчанию), сигналы отмены, настраиваемые ретраи, кэширование fetch и поддержка пользовательских заголовков.
  • Added: Внедрена структурированная ошибка Context7Error с полями для статуса, кода, ID запроса, лимитов и причин сбоя.
  • Fixed: Теперь корректно учитывается параметр отключения повторных попыток (disabled retries).
@upstash/context7-mcp@4.0.5patch
🕐 2 мес назад · релиз на GitHub ↗

Обновление Context7 MCP: усиление аутентификации для Claude Code, настройка подписок и удаление устаревшего заголовка.

  • Added: Внедрена обязательная аутентификация и отдельный учёт использования для плагина Claude Code.
  • Added: Увеличена ёмкость HTTP-подписок по умолчанию; теперь можно настраивать лимит через переменную MCP_MAX_SUBSCRIPTIONS.
  • Deprecated: Удалён устаревший заголовок AES-CBC client-IP, так как внедрена аутентификация.
@upstash/context7-mcp@4.0.4patch
🕐 2 мес назад · релиз на GitHub ↗

Исправлена обработка заголовка X-Context7-API-Key и добавлена аутентификация через AES-GCM.

  • Fixed: Теперь HTTP-запросы MCP корректно учитывают заголовок X-Context7-API-Key.
  • Added: Добавлена аутентификация пересылки IP-адресов клиента через краткосрочные AES-GCM-подписи.
ctx7@0.5.9patch
🕐 2 мес назад · релиз на GitHub ↗

Исправление ошибок: корректная работа с библиотеками в Git Bash (Scoop) и сохранение настроек Codex TOML при ротации ключей.

  • Fixed: Исправлено искажение идентификаторов библиотек в среде Git Bash при установке Git через Scoop.
  • Fixed: Настройки Codex TOML теперь сохраняются при ротации ключей API stdio.
@upstash/context7-mcp@4.0.3patch
🕐 2 мес назад · релиз на GitHub ↗

Исправлена валидация OAuth-ответов: теперь клиенты проверяют issuer через Clerk.

  • Fixed: Клиенты теперь корректно валидируют ответы авторизации, сверяя issuer с тем, что возвращает Clerk.
@upstash/context7-opencode@0.1.0patch
🕐 2 мес назад · релиз на GitHub ↗

Вышла версия @upstash/context7-opencode@0.1.0.

@upstash/context7-mcp@4.0.2patch
🕐 2 мес назад · релиз на GitHub ↗

Исправлены утечки соединений и таймауты API-запросов в Context7 MCP.

  • Fixed: Добавлен 60-секундный таймаут для вызовов Context7 API, предотвращающий зависание запросов.
  • Fixed: Отключены SSE-сердцебины, устраняющие утечку соединений при зависании потоков.
@upstash/context7-mcp@4.0.0majorbreaking
🕐 3 мес назад · релиз на GitHub ↗

Переход на SDK v2 и протокол 2026-07-28: HTTP-сервер стал stateless, сессии на Redis удалены.

  • Breaking: Миграция на SDK v2 и протокол 2026-07-28.
  • Breaking: Удалена поддержка сессий на базе Redis.
  • Added: HTTP-обслуживание стало stateless для всех клиентов.
ctx7@0.5.7patch
🕐 3 мес назад · релиз на GitHub ↗

Исправлена передача API-ключа в заголовке Authorization для корректной работы с Codex.

  • Fixed: ctx7 setup теперь использует стандартный заголовок Authorization: Bearer вместо CONTEXT7_API_KEY.
  • Fixed: Устранена ошибка invalid_grant в Codex, возникавшая из-за неверного определения режима аутентификации.
  • Хостинговый эндпоинт поддерживает оба формата заголовков, поэтому старые конфигурации остаются рабочими.
ctx7@0.5.4patch
🕐 4 мес назад · релиз на GitHub ↗

Уточнено описание запроса query-docs: теперь требуется запрашивать одну концепцию за раз для избежания размытых результатов.

  • Fixed: Уточнено описание запроса query-docs: теперь требуется запрашивать одну концепцию за раз для избежания размытых результатов.
@upstash/context7-mcp@3.2.2patch
🕐 4 мес назад · релиз на GitHub ↗

Исправлена валидация токенов доступа Enterprise-Managed Auth (id-jag) на стороне MCP-сервера.

  • Fixed: Добавлена валидация токенов доступа Enterprise-Managed Auth (id-jag) непосредственно в MCP-сервере.
  • Added: Обеспечена возможность аутентификации клиентов Context7 через корпоративные IdP (например, Okta) с использованием расширения MCP Enterprise-Managed Authorization.