Context7 MCP Server

Context7 MCP Server

Сервер Context7 MCP позволяет LLM получать актуальную, специфичную для версии документацию и примеры кода из широкого диапазона библиотек и пакетов, напрямую внедряя эту информацию в ваши запросы, чтобы исключить устаревший код, вымышленные API и общие ответы.

Author: upstash


Просмотреть протокол

Что такое сервер Context7 MCP?

Сервер Context7 MCP — это открытый MCP-сервер, который действует как динамический мост для документации и примеров кода для LLM и инструментов разработки искусственного интеллекта. Подключаясь через Протокол Контекста Модели (MCP), он извлекает и предоставляет актуальные, авторитетные документы и практические примеры для библиотек или фреймворков, используемых в ваших запросах, поддерживая точность и актуальность кодирования. Он совместим с популярными редакторами и инструментами, такими как Cursor, Claude Desktop, Windsurf, Zed и другими.

Как настроить сервер Context7 MCP

Вы можете настроить сервер Context7 MCP, добавив его в конфигурацию MCP вашего инструмента. Общие подходы:

  • NodeJS: Используйте npx (или bunx/deno), чтобы запустить последний пакет, обновив конфигурацию клиента MCP: 
    {
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
}
  • Редакторы/IDE: Перейдите в настройки (например, Cursor или VS Code) и добавьте Context7 как глобальный MCP-сервер, используя рекомендованную конфигурацию, или установите через соответствующий маркетплейс расширений.
  • Docker: Соберите и запустите предоставленный Dockerfile, затем настройте вашу конфигурацию, чтобы выполнить команду Docker как ваш MCP-сервер.
  • Smithery: Используйте npx -y @smithery/cli install @upstash/context7-mcp --client claude для интеграции с Claude Desktop.
  • Убедитесь, что у вас установлена версия Node.js v18+, для лучшей совместимости, и смотрите документацию MCP вашего инструмента для получения конкретных деталей конфигурации.

Как использовать сервер Context7 MCP

  1. Включите Context7 в ваш запрос: Когда вы пишете кодовый запрос, добавьте use context7 в конце вашего указания (например, Создайте базовый проект Next.js с маршрутизатором приложений. use context7).
  2. Интеграция LLM: LLM или помощник ИИ обнаруживает команду use context7 и автоматически запрашивает сервер Context7 MCP на получение актуальной документации и примеров кода.
  3. Улучшение запросов: Извлеченный и внедренный контент улучшает вывод LLM — больше никаких устаревших API или вымышленных ответов.
  4. Не требуется переключение вкладок: Все происходит в контексте вашего чата по разработке, IDE или помощника по программированию.

Ключевые функции

  • Актуальная документация: Извлекает официальную, актуальную документацию и примеры кода для тысяч библиотек.
  • Поддержка нескольких инструментов: Бесшовно интегрируется с Cursor, Claude Desktop, VS Code, Zed и любым совместимым с MCP агентом или IDE.
  • Легкая настройка: Простая конфигурация — работает через npx, bunx, deno, Docker или маркетплейс расширений.
  • Динамическое внедрение контекста: Предоставляет документы, актуальные для контекста, прямо в запросы LLM.
  • API инструментов: Предоставляет выполняемые действия (такие как resolve-library-id и get-library-docs) через протокол MCP.
  • Открытое и расширяемое: Проект, управляемый сообществом, лицензированный MIT и легко адаптируемый к новым средам или рабочим процессам.

Сценарии использования

  • AI совместное программирование: Увеличьте завершения кода LLM с актуальными примерами и API, соответствующими версии.
  • Отладка ошибок: Мгновенно извлекайте актуальные шаги по устранению неполадок и документацию для решения проблем с кодом.
  • Изучение новых фреймворков: Запрашивайте код с лучшими практиками и руководства для незнакомых библиотек и пакетов.
  • Миграция устаревших систем: Получите точный синтаксис и изменения API для обновления пакетов, минимизируя ручные исследования.

FAQ

Вопрос 1: Что мне делать, если я получаю ошибку ERR_MODULE_NOT_FOUND при запуске сервера Context7 MCP?
Попробуйте использовать bunx вместо npx в вашей конфигурации. Это часто решает проблемы с разрешением модулей, особенно в средах, где npx не работает как ожидалось или обработка ESM Node вызывает проблемы.

Вопрос 2: Могу ли я запустить сервер Context7 MCP в контейнере Docker?
Да! Соберите Docker-образ, используя предоставленный Dockerfile, затем обновите конфигурацию клиента MCP, чтобы выполнить команду запуска Docker, как показано в руководстве. Убедитесь, что демон Docker работает, и тег образа соответствует вашей конфигурации.

Вопрос 3: Как я могу использовать Context7 из разных редакторов, таких как VS Code, Cursor или Zed?
Для каждого основного редактора и инструмента есть готовые конфигурационные фрагменты. Вы можете использовать расширение/маркетплейс или вручную добавить правильное определение сервера в ваш конфигурационный файл MCP, как показано выше.

Вопрос 4: Как я могу убедиться, что предоставленная документация точная и актуальная?
Context7 извлекает документы и примеры непосредственно из последних доступных официальных источников и индексируемых репозиториев. Однако, так как это проект, управляемый сообществом, всегда проверяйте содержимое — используйте функцию "Сообщить", если вы заметили неточности.

Вопрос 5: LLM генерирует общие или устаревшие коды — что может быть не так?
Убедитесь, что в вашем запросе есть use context7, и подтвердите, что ваша конфигурация MCP работает (проверьте через инспектор MCPI). Также проверьте ваши настройки сети/брандмауэра, если запускаете локально или через Docker.