Context7 MCP Server

MCP сервер для получения актуальной документации библиотек в реальном времени

Context7 — это MCP сервер, который предоставляет AI-ассистентам доступ к актуальной документации и примерам кода для любых библиотек. Решает проблему устаревших знаний LLM о API и синтаксисе.

Зачем нужен Context7

Актуальные данные

LLM обучены на данных прошлых лет. Context7 предоставляет документацию в реальном времени

Меньше галлюцинаций

Вместо выдумывания API, ассистент получает реальные примеры из официальной документации

30+ клиентов

Поддержка Cursor, Claude Desktop, VS Code, Windsurf, Zed и многих других

Простая интеграция

Один npx-запуск или удалённый сервер — никаких сложных настроек

Архитектура

Два режима работы

Удалённый сервер (рекомендуется)

Не требует локальной установки. Подключение к https://mcp.context7.com/mcp:

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

Локальный сервер

Запуск через npx без установки:

npx -y @upstash/context7-mcp@latest

Инструменты

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

resolve-library-id

Поиск библиотеки по названию и получение Context7-совместимого ID.

Параметр	Тип	Описание
`libraryName`	string	Название библиотеки для поиска

Ответ содержит:

Library ID в формате /org/project
Описание библиотеки
Количество сниппетов кода
Репутация источника (High/Medium/Low)
Benchmark Score (качество, макс. 100)
Доступные версии

get-library-docs

Получение документации по library ID.

Параметр	Тип	Описание
`context7CompatibleLibraryID`	string	ID библиотеки из resolve-library-id
`mode`	`code` \| `info`	`code` — примеры кода, `info` — концептуальные гайды
`topic`	string?	Фильтр по теме (напр., `hooks`, `routing`)
`page`	number?	Страница пагинации (1-10)

Установка по клиентам

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

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Или удалённый сервер:

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

Добавьте в ~/.cursor/mcp.json:

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

Или через Settings → MCP Servers → Add Server:

Type: command
Command: npx -y @upstash/context7-mcp@latest

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

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

Добавьте в ~/.claude/settings.json:

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

Добавьте в ~/.codeium/windsurf/mcp_config.json:

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

Добавьте в settings.json Zed:

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

Использование

После подключения Context7 используйте фразу “use context7” в промпте:

Создай React хук для debounce. use context7

Как настроить маршрутизацию в Next.js 15? use context7

Покажи пример работы с Prisma транзакциями. use context7

AI-ассистент автоматически:

Вызовет resolve-library-id для поиска библиотеки
Получит актуальную документацию через get-library-docs
Использует реальные примеры кода в ответе

Режимы документации

API Key (опционально)

Для увеличения лимитов запросов получите бесплатный API-ключ на context7.com/dashboard.

export CONTEXT7_API_KEY=ctx7sk_your_key_here

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

Для удалённого сервера используйте заголовок:

Authorization: Bearer ctx7sk_your_key_here

или

Context7-API-Key: ctx7sk_your_key_here

HTTP Transport

Для продакшен-деплоя Context7 поддерживает HTTP режим:

npx -y @upstash/context7-mcp --transport http --port 3000

Флаг	Описание
`--transport stdio`	Стандартный ввод/вывод (по умолчанию)
`--transport http`	HTTP сервер
`--port 3000`	Порт для HTTP (только с `--transport http`)
`--api-key <key>`	API ключ (только с `--transport stdio`)

Формат Library ID

Context7 использует формат /org/project или /org/project/version:

Пример	Описание
`/vercel/next.js`	Next.js (последняя версия)
`/vercel/next.js/v14.3.0`	Next.js конкретной версии
`/mongodb/docs`	MongoDB документация
`/supabase/supabase`	Supabase
`/withastro/docs`	Astro

Proxy-поддержка

Context7 автоматически использует прокси из переменных окружения:

export HTTPS_PROXY=http://proxy.example.com:8080
# или
export HTTP_PROXY=http://proxy.example.com:8080

Troubleshooting

Проверка подключения

# Локальный сервер
npx @modelcontextprotocol/inspector npx -y @upstash/context7-mcp

# Откройте http://localhost:6274
# Tools → resolve-library-id → libraryName: "react"

Context7 MCP Server

Зачем нужен Context7

Архитектура

Два режима работы

Удалённый сервер (рекомендуется)

Локальный сервер

Инструменты

resolve-library-id

get-library-docs

Установка по клиентам

Использование

Режимы документации

API Key (опционально)

HTTP Transport

Формат Library ID

Proxy-поддержка

Troubleshooting

Проверка подключения

Ссылки

Начало работы

SDK по языкам

Эталонные серверы

Развёртывание

Оптимизация

Безопасность

Примеры

Справочник