MCP-сервер долгосрочной памяти ИИ

Сервер протокола контекста модели (MCP), обеспечивающий постоянную долгосрочную память для ИИ-агентов. Разработан для реального использования с Claude Code, позволяя ИИ-системам сохранять воспоминания между сессиями.

Возможности

• Многоуровневая архитектура памяти: 3-уровневая система (факты → опыт → цепочки решений)

• Семантический поиск: извлечение на основе эмбеддингов с использованием косинусного сходства

• Затухание памяти: затухание на основе активации — воспоминания, к которым обращаются, остаются активными, неиспользуемые — исчезают

• Учет эмоций: хранит эмоциональную валентность и интенсивность, обеспечивая эффекты «ярких воспоминаний» (flashbulb memory)

• Автоматическое всплытие: автоматическое извлечение памяти с помощью хуков, запускаемых контекстом разговора

• Дедупликация: автоматическое объединение похожих воспоминаний (порог сходства >80%)

Related MCP server: Recall

Архитектура

┌─────────────────────────────────────────┐
│              Claude Code                │
│         (or any MCP client)             │
├─────────────────────────────────────────┤
│            MCP Protocol                 │
├─────────────────────────────────────────┤
│          Memory MCP Server              │
│  ┌───────────┐  ┌──────────────────┐   │
│  │  Write /   │  │  Surface /       │   │
│  │  Update /  │  │  Search /        │   │
│  │  Delete    │  │  Read            │   │
│  └─────┬─────┘  └────────┬─────────┘   │
│        │                 │              │
│  ┌─────▼─────────────────▼─────────┐   │
│  │         SQLite Database          │   │
│  │  memories + embeddings + decay   │   │
│  └─────────────────────────────────┘   │
├─────────────────────────────────────────┤
│         Auto-Surface Hook              │
│  (keyword matching on user input)      │
└─────────────────────────────────────────┘

Схема памяти

Инструменты MCP

Механизм затухания

Воспоминания затухают на основе last_activated, а не created_at. Воспоминание, к которому постоянно обращаются, остается активным бесконечно. Пороги затухания:

• Низкая важность (1-2) + не активировалось 7 дней → затухание

• Средняя важность (3) + не активировалось 14 дней → затухание

• Высокая важность (4-5) + не активировалось 30 дней → затухание

• Закрепленные воспоминания никогда не затухают

Вдохновлено исследованиями консолидации человеческой памяти — на основе 8 статей (см. design doc).

Хук автоматического всплытия

auto_surface.cjs работает как хук UserPromptSubmit в Claude Code. При каждом сообщении пользователя он:

1. Извлекает ключевые слова из сообщения

2. Ищет совпадения в базе данных памяти

3. Внедряет релевантные воспоминания в контекст разговора

Это обеспечивает пассивное извлечение без явных команд поиска.

Настройка

npm install

Добавьте в конфигурацию MCP Claude Code:

{
  "mcpServers": {
    "memory": {
      "command": "node",
      "args": ["path/to/memory-mcp/index.js"]
    }
  }
}

Проектные решения

• SQLite вместо векторной БД: простота развертывания, один файл, достаточно для <10 тыс. воспоминаний

• Затухание на основе активации вместо временного: имитирует человеческую память — используемые воспоминания усиливаются, неиспользуемые — исчезают

• Дедупликация эмбеддингов: предотвращает раздувание памяти из-за повторяющихся похожих событий

• Многоуровневая архитектура: отделяет факты (стабильные) от опыта (контекстуального) и решений (действенных)

Исследовательские ссылки

Построено на основе исследований из 8 статей:

• Generative Agents (Stanford, 2023): поток памяти, рефлексия, планирование/реакция

• MemGPT (2023): многоуровневая память с управлением страницами в стиле ОС

• LUFY (2024): механизм забывания с учетом эмоционального возбуждения

• MemoRAG (2024): извлечение на основе памяти с двойной оценкой

• Mem0 (2024): графовая память с автоматическим извлечением и дедупликацией

• A-Mem (2024): самоорганизующиеся агентные сети памяти

• LoCoMo (2024): бенчмарк памяти для длинных контекстов разговора

• Chloe/Noah (Community): четырехмерная память ИИ-компаньона

См. docs/design.md для подробного анализа влияния каждой статьи.

Статус

В активном ежедневном использовании. 95+ воспоминаний за 17 сессий. Итеративное развитие на основе реальных паттернов использования.

Лицензия

MIT