Context7 MCP — актуальная документация для любой подсказки

Context7 — это MCP-сервер, который автоматически подтягивает свежую документацию и примеры кода для библиотек и фреймворков прямо в ваш промпт. Больше никаких устаревших ответов, вымышленных API и кода под старые версии пакетов.

Просто добавьте в запрос фразу use context7, и LLM получит актуальные примеры из официальных источников — без переключения вкладок и галлюцинаций.

🌐 Официальный сайт 📦 Пакет на npm

Требования

• Node.js >= v18.0.0
• Любой MCP-клиент: Cursor, Windsurf, Claude Desktop, VS Code (Insiders) или Claude Code

Быстрый старт

Установка через Smithery (для Claude Desktop)

npx -y @smithery/cli install @upstash/context7-mcp --client claude

Установка в Cursor

Откройте Settings → Cursor Settings → MCP → Add new global MCP server и добавьте в ~/.cursor/mcp.json:

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

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

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

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

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

Установка в Windsurf

Добавьте в конфигурационный файл MCP (см. документацию Windsurf MCP):

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

Установка в VS Code (Insiders)

Используйте быструю ссылку для установки:

• VS Code Insiders

Либо добавьте в конфигурационный файл VS Code (см. документацию):

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

Установка в Claude Code

Выполните команду:

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

Подробнее — в документации Claude Code MCP.

Установка в Claude Desktop

Добавьте в claude_desktop_config.json:

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

Подробнее — в документации Claude Desktop MCP.

Инструменты (Tools)

Сервер предоставляет два инструмента:

1. resolve-library-id

Преобразует общее название библиотеки в совместимый с Context7 ID.

• Параметр: libraryName (обязательный) — имя библиотеки.

2. get-library-docs

Загружает документацию для библиотеки по её ID.

• Параметры:
  • context7CompatibleLibraryID (обязательный) — ID, полученный из resolve-library-id.
  • topic (опционально) — раздел документации, например "routing", "hooks".
  • tokens (опционально, по умолчанию 5000) — максимальное количество токенов в ответе (значения менее 5000 автоматически поднимаются до 5000).

Пример использования

Добавьте фразу use context7 в ваш промпт внутри Cursor или другого MCP-клиента:

Создай базовый Next.js проект с app router. use context7

Напиши скрипт для удаления строк, где город — пустая строка, для PostgreSQL. use context7

Context7 сам подставит актуальные примеры из официальной документации.

Решение проблем

Ошибка ERR_MODULE_NOT_FOUND

Попробуйте заменить npx на bunx:

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

Другие ошибки MCP-клиента

• Удалите @latest из имени пакета.
• Попробуйте bunx вместо npx.
• Попробуйте deno в качестве альтернативы.

Разработка

Склонируйте репозиторий и установите зависимости:

bun i

Сборка:

bun run build

Пример локальной конфигурации:

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

Для тестирования с MCP Inspector:

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

Лицензия

MIT © Upstash