memory-mcp

Автономный MCP-сервер для постоянной памяти агента — уровни кратко- и долгосрочного хранения, измеримая надёжность и сопровождение жизненного цикла — на базе SQLite (FTS5 + sqlite-vec) с локальными эмбеддингами MiniLM. Никаких внешних сервисов, никаких API-ключей.

Требования

• Node.js >= 22

• Пакет поставляется со скомпилированным JavaScript, поэтому инструментарий TypeScript во время выполнения не требуется.

Related MCP server: localmem-mcp

Установка

npm install @jommar/memory-mcp

Предусмотрены два исполняемых файла:

Быстрый старт

stdio (по умолчанию)

Укажите вашему MCP-клиенту путь к исполняемому файлу сервера:

{
  "mcpServers": {
    "memory": {
      "command": "memory-mcp-server"
    }
  }
}

Или запустите его напрямую:

memory-mcp-server

С помощью npx явно укажите серверный бинарник (пакет установится при первом использовании):

npx -y -p @jommar/memory-mcp memory-mcp-server

HTTP (только localhost)

MEMORY_TRANSPORT=http memory-mcp-server

HTTP-эндпоинт по умолчанию привязывается к 127.0.0.1:3000 и на одном и том же эндпоинте поддерживает как современную (2026-07-28), так и устаревшую (2025-11-25) версии протокола, поэтому подключиться может любой MCP-клиент. Сервер не хранит состояние между запросами — идентификатор сессии не требуется.

Первый запуск

Хранилище создаётся автоматически по пути ~/.memory-mcp/memory.db. Эмбеддинги работают по принципу offline-first: модель не скачивается, пока вы не дадите явное согласие.

# opt in to the one-time model download (about 23 MB, MiniLM-L6, q8 quantized)
MEMORY_EMBEDDING_OFFLINE=false memory-mcp-server

Пока модель недоступна, remember и recall продолжают работать — используется только поиск по ключевым словам. Используйте команду CLI reindex, чтобы после установки модели добавить недостающие векторы.

Конфигурация

Все параметры задаются через переменные окружения MEMORY_* (без файла конфигурации):

Инструменты

Зарегистрировано десять инструментов: remember, recall, get, update, forget, list, confirm, contradict, promote, consolidate. Полное описание входных параметров и поведения — в docs/tools.md.

remember принимает необязательный параметр interactive: при обнаружении почти дублирующихся записей он может попросить клиента объединить их или создать новую (MRTR), а для клиентов без поддержки интерактивного режима корректно упрощается.

CLI обслуживания хранилища

memory-mcp export ./out      # write every memory as a markdown frontmatter file
memory-mcp import ./staging  # validate, then import (never overwrites existing keys)
memory-mcp reindex           # rebuild FTS + vector indexes from stored content
memory-mcp stats             # print store counts

Документация

• docs/tools.md — справочник по инструментам

• docs/reliability.md — модель надёжности и правила жизненного цикла (движок в режиме «только отчёт», лежащий в основе consolidate)

Лицензия

MIT — см. LICENSE.