Mnemosyne — долгая память агента в одном SQLite

Mnemosyne

Локальная память с доказательствами: что агент узнал и откуда, а при исправлении источника зависимые записи снимаются

  • 159 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Агент пишет в локальную базу и читает из нее; запись «забыть» опасна и включается только отдельным флагом
  • Файл базы лежит в проекте и может попасть в репозиторий, если не добавить его в .gitignore
Все причины и проверки

28naem-del/mnemosyne

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/mnemosyne

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Агент пишет в локальную базу и читает из нее; запись «забыть» опасна и включается только отдельным флагом
  • Файл базы лежит в проекте и может попасть в репозиторий, если не добавить его в .gitignore

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Mnemosyne хранит долгую память агента в одном файле SQLite. У каждой записи есть источник и уровень доверия, а после исправления версия остается доступной для просмотра. Модель, ключ API, сервер базы и Docker для локального движка не нужны. Главная идея в зависимостях. Если исправлено требование, записи (процедуры, навыки), которые на него опирались, снимаются, и следующий агент начинает с того, что подтверждают актуальные источники, а не повторяет устаревший урок. В выпуске 3.0 предварительно доступно предложение необъявленных зависимостей на проверку. Память можно переиграть по состоянию на прошлый момент, а `bisect` находит записи, вытеснившие нужное при неудачном поиске. Доступ идет через MCP для Claude Code, Cursor и Codex, через SDK на TypeScript, CLI и защищенный HTTP с клиентом на Python и живым инспектором. Команда `mnemosy mcp` требует параметры `--db`, `--workspace` и `--agent`; в Claude Code через плагин доступно 16 инструментов. Устанавливается пакет `mnemosy-ai` для Node.js 22.16 или новее.

Для кого. Разработчикам, которые строят агентов с долгой памятью и хотят видеть источник каждого знания и снимать устаревшее при правке требований.

Подходит, если

  • Требование изменилось, и агент не должен больше применять процедуры, построенные на старой версии
  • Нужно понять, откуда агент взял утверждение и насколько этому источнику можно доверять
  • Запрос к памяти не вернул нужную запись, и надо найти, что ее вытеснило
  • Вы подключаете одну память к Claude Code, Cursor и Codex, не размещая базу на сервере

Не подходит, если

  • Нужна память для общения с пользователем: инструмент хранит знания агента с доказательствами, а не профиль человека
  • Вам нужен готовый облачный сервис памяти с панелью и командной работой
  • На платформе нельзя поставить Node.js 22.16: без него пакет не запустится

Пример запроса к агенту

Запомни, что сборка проекта требует Node 22, укажи источник этой записи, а потом покажи, какие процедуры опирались на старое требование Node 20.

MCP

Транспорт
stdio, http
Авторизация
не нужна

Ограничения

Для запуска нужен Node.js 22.16 или новее и `npx` в PATH. В README две ветки: стабильная 2.0.0 и предварительная 3.0.0-rc.4 (`next`), у предварительной часть свойств, например консолидация с проверкой исходов, еще на этапе выпуска. Не путайте проект с одноименным Python-репозиторием mnemosyne-oss/mnemosyne (пакет mnemosyne-memory): у них разный код и авторы.

Файл базы создается с правами 0600 и вместе с каталогом попадает в проект, поэтому `.mnemosyne/` добавляют в .gitignore. Для Codex и Hermes в README есть пометки «Documented»: команды описаны по документации хоста и автор их не запускал.

Как отключить. Удалите сервер командой `claude mcp remove mnemosyne` или плагин через /plugin, затем файл базы .mnemosyne/memory.sqlite, если память больше не нужна.

Частые вопросы

Как подключить Mnemosyne к Claude Code?

Выполните `claude mcp add mnemosyne -- npx -y -p mnemosy-ai@next mnemosy mcp --db ./.mnemosyne/memory.sqlite --workspace my-project --agent assistant`. Либо поставьте плагин: `claude plugin marketplace add 28naem-del/mnemosyne` и `claude plugin install mnemosyne@mnemosy-ai`.

Что происходит с памятью, когда исправляют источник?

Записи, которые числились зависимыми от этого источника, снимаются, а прежняя версия остается доступной. Следующий агент получает то, что подтверждают актуальные записи, и не повторяет устаревший урок.

Нужен ли ключ API модели?

Нет, локальный движок работает без ключа, модели и сервера базы. Демонстрация `mnemosy demo` тоже идет офлайн на синтетических данных и сама проверяет каждое утверждение, пока работает.

Какую версию ставить, стабильную или предварительную?

Стабильная 2.0.0 ставится как `mnemosy-ai@2.0.0`, предварительная 3.0.0-rc.4 как `mnemosy-ai@next`. Набор инструментов MCP у них одинаков. Демо `mnemosy demo` на 3.0 доказывает пять свойств памяти, на 2.0.0 запускается более ранний сценарий.

Как запретить агенту менять и удалять память?

Запустите сервер с флагом `--read-only`: мутирующие инструменты пропадут. Забывание работает только при явном запуске с `--allow-destructive`. Модель не может выбрать другое рабочее пространство, повысить доверие к своей записи или отчитаться об успешной проверке.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы

MCP-сервер с памятью самого агента: он решает, что запомнить, и просыпается с этим в каждой сессии, данные в одном файле SQLite

MCP-серверШирокий доступ158Звезды репозитория

Локальный MCP-сервер памяти для агентов: история сессий, индекс кодовой базы и граф понятий в одной базе SQLite

MCP-серверРасширенный доступ438Звезды репозитория

Одна программа дает Claude Code, Codex и Cursor общую память между сессиями: граф знаний лежит локально, ключи API не нужны

CLIРасширенный доступ717Звезды репозитория

Локальный слой памяти: импортирует память Claude Code, Codex, mem0 и других в SQLite и отдает агентам через CLI и MCP.

ПлагинРасширенный доступ188Звезды репозитория

Долговременная память агента в папке связанных markdown-заметок, чтобы Claude Code помнил проект между сессиями

MCP-серверРасширенный доступ336Звезды репозитория

Mnemo Cortex хранит память агентов локально: запоминает по смыслу, сжимает сессии, делится между агентами и подключается по MCP.

MCP-серверРасширенный доступ160Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
Mnemosyne — долгая память агента в одном SQLite (эта карточка)нетне нужна159
agentmemoryдане нужна30 340память без связи записей с источниками и снятия зависимых
MCP Memory Serviceнетне нужна2 117общая память по MCP с серверной частью

Коротко о README

README открывается тезисом «следующий агент начинает мудрее», затем идут демо с пятью доказательствами, новинки версии 3.0, установка и подключение для Claude Code, Cursor, Codex и Hermes Agent, выбор движка, измерения и границы эксплуатации. Отдельная заметка отличает проект от Python-проекта с тем же названием.

Бейдж для README

Сообщить о проблеме