mnemo — MCP-сервер для Claude Code: что делает и как установить
Локальная база памяти для ИИ-агентов с гибридным поиском и графом связей. Сохраняет контекст между сессиями в файл SQLite.
claude mcp add mnemo -e API_KEYS=<API_KEYS> -- uvx mnemo-mcpЧто делает mnemo
Сервер сохраняет факты и контекст работы ассистента в локальной базе SQLite в режиме WAL. Для поиска записей используется гибридная схема: полнотекстовый FTS5 объединяется с векторным расширением sqlite-vec через алгоритм Reciprocal Rank Fusion, после чего модель ранжирует выдачу с учётом давности и важности. Во второй версии также работает темпоральный граф сущностей с контролем периодов актуальности данных.
Пакет mnemo-mcp запускается через uvx. При старте сервер требует переменную окружения API_KEYS, без которой обращение к внешним моделям ранжирования завершится ошибкой. Облачные механизмы синхронизации из проекта убрали, поэтому резервные копии базы нужно создавать внешними инструментами вроде rclone.
Какие задачи решает
- сохранять контекст задач и договорённости между сессиями агента
- находить нужные факты комбинацией ключевых слов и векторных эмбеддингов
- отслеживать изменения связей между сущностями проекта во времени
- понижать приоритет устаревших записей за счёт временного затухания
Примеры запросов агенту
- Проверь в памяти mnemo, какие соглашения по структуре API мы приняли ранее
- Сохрани это решение по миграции таблиц в постоянную память с высоким приоритетом
- Покажи историю изменений и граф связей для модуля аутентификации
Как установить mnemo
Командой платформы
claude mcp add mnemo -e API_KEYS=<API_KEYS> -- uvx mnemo-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mnemo-mcp <команда>
Командой платформы
codex mcp add mnemo --env API_KEYS=<API_KEYS> -- uvx mnemo-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mnemo-mcp <команда>
Файл настроек
{
"mcpServers": {
"mnemo": {
"command": "uvx",
"args": [
"mnemo-mcp"
],
"env": {
"API_KEYS": "<API_KEYS>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mnemo-mcp <команда>
Файл настроек
{
"servers": {
"mnemo": {
"type": "stdio",
"command": "uvx",
"args": [
"mnemo-mcp"
],
"env": {
"API_KEYS": "<API_KEYS>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mnemo-mcp <команда>
Командой платформы
gemini mcp add -e API_KEYS=<API_KEYS> mnemo uvx mnemo-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mnemo-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mnemo
Как установить mnemo в Claude Code?
Выполните команду claude mcp add mnemo -e API_KEYS=<API_KEYS> -- uvx mnemo-mcp, подставив свой ключ. Также поддерживается вызов с явным указанием транспорта: claude mcp add --env API_KEYS=<API_KEYS> --transport stdio mnemo -- uvx mnemo-mcp.
Как mnemo находит нужные воспоминания?
Сервер сопоставляет результаты полнотекстового индекса FTS5 и векторного поиска sqlite-vec через алгоритм RRF. Затем список переранжируется кросс-энкодером с учётом давности и флага важности.
Где хранятся записи памяти?
Вся информация остаётся на локальном диске в файле базы данных SQLite с включённым журналом предзаписи WAL.
