# mnemo

Локальная база памяти для ИИ-агентов с гибридным поиском и графом связей. Сохраняет контекст между сессиями в файл SQLite.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12
- Автор: n24q02m
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/n24q02m/mnemo
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/mcp/mnemo

## Что делает

Сервер сохраняет факты и контекст работы ассистента в локальной базе SQLite в режиме WAL. Для поиска записей используется гибридная схема: полнотекстовый FTS5 объединяется с векторным расширением sqlite-vec через алгоритм Reciprocal Rank Fusion, после чего модель ранжирует выдачу с учётом давности и важности. Во второй версии также работает темпоральный граф сущностей с контролем периодов актуальности данных.

Пакет `mnemo-mcp` запускается через `uvx`. При старте сервер требует переменную окружения `API_KEYS`, без которой обращение к внешним моделям ранжирования завершится ошибкой. Облачные механизмы синхронизации из проекта убрали, поэтому резервные копии базы нужно создавать внешними инструментами вроде rclone.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `API_KEYS` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add mnemo -e API_KEYS=<API_KEYS> -- uvx mnemo-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mnemo-mcp <команда>

### Codex

**Командой платформы**
```bash
codex mcp add mnemo --env API_KEYS=<API_KEYS> -- uvx mnemo-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mnemo-mcp <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mnemo": {
            "command": "uvx",
            "args": [
                "mnemo-mcp"
            ],
            "env": {
                "API_KEYS": "<API_KEYS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mnemo-mcp <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mnemo": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "mnemo-mcp"
            ],
            "env": {
                "API_KEYS": "<API_KEYS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mnemo-mcp <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e API_KEYS=<API_KEYS> mnemo uvx mnemo-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mnemo-mcp <команда>

## Когда брать
- сохранять контекст задач и договорённости между сессиями агента
- находить нужные факты комбинацией ключевых слов и векторных эмбеддингов
- отслеживать изменения связей между сущностями проекта во времени
- понижать приоритет устаревших записей за счёт временного затухания

## Примеры запросов агенту
- Проверь в памяти mnemo, какие соглашения по структуре API мы приняли ранее
- Сохрани это решение по миграции таблиц в постоянную память с высоким приоритетом
- Покажи историю изменений и граф связей для модуля аутентификации

## Похожие
- [SAME - Stateless Agent Memory Engine](https://affpapa.org/nevibecode/mcp/same-stateless-agent-memory-engine.md) — MCP-сервер · ★ 24
- [Local Memory](https://affpapa.org/nevibecode/mcp/local-memory.md) — MCP-сервер · ★ 15
- [claude-self-reflect](https://affpapa.org/nevibecode/plugins/claude-self-reflect.md) — плагин · ★ 228
- [V3 Memory Unification](https://affpapa.org/nevibecode/skills/v3-memory-unification.md) — скилл · 1100 установок
- [VelesDB Memory](https://affpapa.org/nevibecode/mcp/velesdb-memory.md) — MCP-сервер · ★ 100
- [turso-cloud](https://affpapa.org/nevibecode/skills/turso-cloud.md) — скилл · 3600 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md