mcp-context-server — MCP-сервер для Claude Code: установка
Сохраняет текстовые и графические данные агентов между сессиями. Помогает делить рабочий контекст между несколькими ИИ через общие ветки и настраивать права доступа.
claude mcp add --env LOG_LEVEL=<LOG_LEVEL> --env STORAGE_BACKEND=<STORAGE_BACKEND> --env MAX_IMAGE_SIZE_MB=<MAX_IMAGE_SIZE_MB> --env MAX_TOTAL_SIZE_MB=<MAX_TOTAL_SIZE_MB> --env DB_PATH=<DB_PATH> --transport stdio mcp-context-server -- uvx mcp-context-serverЧто делает mcp-context-server
Хранилище работает поверх SQLite или PostgreSQL, связывая записи через идентификаторы UUIDv7. Для поиска информации сервер комбинирует полнотекстовый поиск, семантические векторные выборки и построчный перебор grep_context. Поверх записей можно строить оглавление navigate_context и вычитывать нужные куски текста по диапазонам строк или символов через read_context_range.
Для многопользовательской среды предусмотрено разграничение прав с токенами JWT, публичным доступом на чтение и политиками RLS в PostgreSQL. Базы данных со второй версии требуют обязательного перехода через утилиту mcp-context-server-migrate, иначе третья ветка с ними работать откажется.
Какие задачи решает
- сохранять текст и картинки между сессиями ИИ
- искать фрагменты документации через гибридный векторный и текстовый поиск
- читать части длинных файлов по номерам строк без загрузки всей записи в контекст
- разграничивать доступ к сохранённым данным между разными участниками через JWT
Примеры запросов агенту
- Сохрани схему архитектуры и текстовое описание в контекст задачи с
thread_idauth-refactor - Найди через
grep_contextвсе упоминания таймаутов в базе контекста - Покажи структуру записи с помощью
navigate_contextи прочитай первые пятьдесят строк черезread_context_range
Как установить mcp-context-server
Командой платформы
claude mcp add --env LOG_LEVEL=<LOG_LEVEL> --env STORAGE_BACKEND=<STORAGE_BACKEND> --env MAX_IMAGE_SIZE_MB=<MAX_IMAGE_SIZE_MB> --env MAX_TOTAL_SIZE_MB=<MAX_TOTAL_SIZE_MB> --env DB_PATH=<DB_PATH> --transport stdio mcp-context-server -- uvx mcp-context-serverВместо <…> подставьте свои значения. Ещё 128 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-context-server <команда>
Командой платформы
codex mcp add mcp-context-server --env LOG_LEVEL=<LOG_LEVEL> --env STORAGE_BACKEND=<STORAGE_BACKEND> --env MAX_IMAGE_SIZE_MB=<MAX_IMAGE_SIZE_MB> --env MAX_TOTAL_SIZE_MB=<MAX_TOTAL_SIZE_MB> --env DB_PATH=<DB_PATH> -- uvx mcp-context-serverВместо <…> подставьте свои значения. Ещё 128 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-context-server <команда>
Файл настроек
{
"mcpServers": {
"mcp-context-server": {
"command": "uvx",
"args": [
"mcp-context-server"
],
"env": {
"LOG_LEVEL": "<LOG_LEVEL>",
"STORAGE_BACKEND": "<STORAGE_BACKEND>",
"MAX_IMAGE_SIZE_MB": "<MAX_IMAGE_SIZE_MB>",
"MAX_TOTAL_SIZE_MB": "<MAX_TOTAL_SIZE_MB>",
"DB_PATH": "<DB_PATH>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 128 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-context-server <команда>
Файл настроек
{
"servers": {
"mcp-context-server": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-context-server"
],
"env": {
"LOG_LEVEL": "<LOG_LEVEL>",
"STORAGE_BACKEND": "<STORAGE_BACKEND>",
"MAX_IMAGE_SIZE_MB": "<MAX_IMAGE_SIZE_MB>",
"MAX_TOTAL_SIZE_MB": "<MAX_TOTAL_SIZE_MB>",
"DB_PATH": "<DB_PATH>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 128 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-context-server <команда>
Командой платформы
gemini mcp add -e LOG_LEVEL=<LOG_LEVEL> -e STORAGE_BACKEND=<STORAGE_BACKEND> -e MAX_IMAGE_SIZE_MB=<MAX_IMAGE_SIZE_MB> -e MAX_TOTAL_SIZE_MB=<MAX_TOTAL_SIZE_MB> -e DB_PATH=<DB_PATH> mcp-context-server uvx mcp-context-serverВместо <…> подставьте свои значения. Ещё 128 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-context-server <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-context-server
Как установить mcp-context-server в Claude Code?
Выполните команду `claude mcp add --env LOG_LEVEL=<LOG_LEVEL> --env STORAGE_BACKEND=<STORAGE_BACKEND> --env MAX_IMAGE_SIZE_MB=<MAX_IMAGE_SIZE_MB> --env MAX_TOTAL_SIZE_MB=<MAX_TOTAL_SIZE_MB> --env DB_PATH=<DB_PATH> --transport stdio mcp-context-server -- uvx mcp-context-server`. Подставьте свои пути и настройки вместо плейсхолдеров.
Что делает mcp-context-server?
Сервер сохраняет текст и изображения для ИИ-ассистентов, организует поиск по ключевым словам и эмбеддингам, а также позволяет агентам обмениваться записями через ветки thread_id.
Что требуется при обновлении со второй версии на третью?
В третьей версии изменилась схема базы данных на ключи UUIDv7, поэтому перед запуском нужно выполнить миграцию существующей базы через утилиту mcp-context-server-migrate.
