tinycontext — MCP-сервер для Claude Code: локальная память агента
Хранит заметки и факты агента в SQLite и отдаёт на отзыв только то, что укладывается в заданный лимит токенов. Пригодится, когда контекст пухнет от старых диалогов.
claude mcp add --env MCP_TRANSPORT=<MCP_TRANSPORT> --env TINYCONTEXT_CONFIG_PATH=<TINYCONTEXT_CONFIG_PATH> --env TINYCONTEXT_MEMORY_DB_PATH=<TINYCONTEXT_MEMORY_DB_PATH> --env TINYCONTEXT_MODELS_DIR=<TINYCONTEXT_MODELS_DIR> --env OTEL_SERVICE_NAME=<OTEL_SERVICE_NAME> --transport stdio tinycontext -- uvx tinysuite-contextЧто делает tinycontext
TinyContext — локальный слой памяти для ИИ-агентов. Записи и их эмбеддинги лежат в SQLite, поиск гибридный: BM25 вместе с векторным ранжированием. Наружу уходит лишь тот объём, который помещается в запрошенный бюджет токенов. Хостингового аккаунта нет, отдельная векторная база тоже не нужна.
Внутри шесть инструментов: save_memories, recall_memories, list_memories, get_memory, update_memory, delete_memory. Записи бывают двух видов: episodic (по умолчанию) и profile — второй хранит устойчивые факты о пользователе и подмешивается к каждому отзыву целиком, в пределах своего бюджета profile_max_tokens. Дедупликация и подсчёт токенов происходят на этапе отзыва, поэтому сохранять можно без опаски.
Нужен Python 3.12 и uvx. При первом запуске команда tinycontext без аргументов поднимает stdio MCP и скачивает выбранный набор ONNX-эмбеддингов в пользовательский каталог данных; база создаётся при первом сохранении или отзыве. Проверить конфигурацию и готовность хранилища можно командой tinycontext doctor.
Какие задачи решает
- удержать память агента между сессиями без облачного сервиса
- уложить отзыв из памяти в лимит токенов
- найти нужную запись по смыслу, а не по точному совпадению
- просмотреть, что вообще накопилось в хранилище
- поправить или удалить устаревший факт о пользователе
Примеры запросов агенту
- Сохрани в память, что этот проект собирается через
uvи Python 3.12. - Найди в памяти всё, что мы решали про схему базы данных.
- Покажи последние записи из памяти за эту неделю.
Как установить tinycontext
Командой платформы
claude mcp add --env MCP_TRANSPORT=<MCP_TRANSPORT> --env TINYCONTEXT_CONFIG_PATH=<TINYCONTEXT_CONFIG_PATH> --env TINYCONTEXT_MEMORY_DB_PATH=<TINYCONTEXT_MEMORY_DB_PATH> --env TINYCONTEXT_MODELS_DIR=<TINYCONTEXT_MODELS_DIR> --env OTEL_SERVICE_NAME=<OTEL_SERVICE_NAME> --transport stdio tinycontext -- uvx tinysuite-contextВместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from tinysuite-context <команда>
Командой платформы
codex mcp add tinycontext --env MCP_TRANSPORT=<MCP_TRANSPORT> --env TINYCONTEXT_CONFIG_PATH=<TINYCONTEXT_CONFIG_PATH> --env TINYCONTEXT_MEMORY_DB_PATH=<TINYCONTEXT_MEMORY_DB_PATH> --env TINYCONTEXT_MODELS_DIR=<TINYCONTEXT_MODELS_DIR> --env OTEL_SERVICE_NAME=<OTEL_SERVICE_NAME> -- uvx tinysuite-contextВместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from tinysuite-context <команда>
Файл настроек
{
"mcpServers": {
"tinycontext": {
"command": "uvx",
"args": [
"tinysuite-context"
],
"env": {
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"TINYCONTEXT_CONFIG_PATH": "<TINYCONTEXT_CONFIG_PATH>",
"TINYCONTEXT_MEMORY_DB_PATH": "<TINYCONTEXT_MEMORY_DB_PATH>",
"TINYCONTEXT_MODELS_DIR": "<TINYCONTEXT_MODELS_DIR>",
"OTEL_SERVICE_NAME": "<OTEL_SERVICE_NAME>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from tinysuite-context <команда>
Файл настроек
{
"servers": {
"tinycontext": {
"type": "stdio",
"command": "uvx",
"args": [
"tinysuite-context"
],
"env": {
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"TINYCONTEXT_CONFIG_PATH": "<TINYCONTEXT_CONFIG_PATH>",
"TINYCONTEXT_MEMORY_DB_PATH": "<TINYCONTEXT_MEMORY_DB_PATH>",
"TINYCONTEXT_MODELS_DIR": "<TINYCONTEXT_MODELS_DIR>",
"OTEL_SERVICE_NAME": "<OTEL_SERVICE_NAME>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from tinysuite-context <команда>
Командой платформы
gemini mcp add -e MCP_TRANSPORT=<MCP_TRANSPORT> -e TINYCONTEXT_CONFIG_PATH=<TINYCONTEXT_CONFIG_PATH> -e TINYCONTEXT_MEMORY_DB_PATH=<TINYCONTEXT_MEMORY_DB_PATH> -e TINYCONTEXT_MODELS_DIR=<TINYCONTEXT_MODELS_DIR> -e OTEL_SERVICE_NAME=<OTEL_SERVICE_NAME> tinycontext uvx tinysuite-contextВместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from tinysuite-context <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о tinycontext
Как установить tinycontext в Claude Code?
Выполните claude mcp add tinycontext -- uvx tinysuite-context. Если нужны переменные окружения, есть вариант с флагами --env и --transport stdio.
Что делает tinycontext?
Держит локальную память агента в SQLite и по запросу возвращает релевантные записи, обрезая их под бюджет токенов. Гибридный поиск сочетает BM25 и векторное ранжирование.
Что нужно для работы tinycontext?
Python 3.12 и uvx. При первом запуске скачивается набор ONNX-эмбеддингов в пользовательский каталог данных, база создаётся при первом сохранении или отзыве.
