NeuralMemory MCP
Постоянная память агента на графе связей: решения и ошибки переживают сессию, без векторной базы и платных вызовов API
- 243 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Хуки плагина запускают команды на старте и остановке сессии и после каждого вызова инструмента, а память записывается на диск
- Облачная синхронизация и резервная копия в Telegram, если их включить, отправляют содержимое памяти во внешние сервисы
Установка
- Работает в
Ручная установка
pip install neural-memoryСтавит CLI `nmem` и MCP-сервер `nmem-mcp`. После перезапуска клиента сервер инициализируется сам.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Хуки плагина запускают команды на старте и остановке сессии и после каждого вызова инструмента, а память записывается на диск
- Облачная синхронизация и резервная копия в Telegram, если их включить, отправляют содержимое памяти во внешние сервисы
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
NeuralMemory хранит опыт агента в виде связанных нейронов и достает его ассоциативным поиском: при запросе активируются родственные понятия, пока не всплывет нужное воспоминание. Связи названы явно (`CAUSED_BY`, `LEADS_TO`, `RESOLVED_BY`, `CONTRADICTS`), поэтому на вопрос «почему упал сервис во вторник» агент идет по цепочке причин. Эмбеддинги не нужны, и бесплатная версия работает полностью локально. MCP-сервер `nmem-mcp` отдает 63 инструмента, но для начала хватает трех: `nmem_remember` сохраняет запись и сам определяет тип, теги и связи, `nmem_recall` достает записи, `nmem_health` ставит оценку состоянию памяти от A до F. Рядом стоит CLI `nmem` (82 команды): `nmem remember`, `nmem recall`, `nmem brain export`, `nmem serve` для веб-панели с графом и временной шкалой. Память делится на четырнадцать типов (факт, решение, ошибка, предпочтение, инструкция и другие), со временем затухает и укрепляется, а эпизоды сворачиваются в устойчивые знания. В хранилище можно загрузить PDF, DOCX, PPTX, HTML, XLSX и CSV или перенести память из ChromaDB, Mem0, Cognee и LlamaIndex. Плагин для Claude Code добавляет три скилла и хуки сессии.
Для кого. Разработчикам, чей агент в Claude Code или Cursor каждую сессию начинает с нуля и забывает принятые решения, найденные ошибки и договоренности по проекту.
Подходит, если
- Архитектурное решение принято неделю назад, а агент в новой сессии советует обратное
- Сбой повторяется, и нужна цепочка причин от симптома до исходного изменения
- Накопленную память в Mem0 или ChromaDB хочется перенести без потери записей
- Память должна жить на нескольких компьютерах, но только в вашем облачном аккаунте: синхронизация идет через собственный Worker в Cloudflare
- Документы проекта в PDF, DOCX и таблицах надо превратить в постоянные знания агента
Не подходит, если
- Хватает файла `CLAUDE.md` или `AGENTS.md` с десятком правил: отдельный сервер памяти избыточен
- Нужен поиск по смыслу на сотнях тысяч записей: он входит в платный Pro, в бесплатной версии поиск идет по ключевым словам
- На машине стоит Python ниже 3.11, пакет его не принимает
Пример запроса к агенту
Вспомни, почему мы отказались от Redis в сервисе очередей, и сохрани итоговое решение по базе как решение с тегом architectureMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
- Нужен Python 3.11 или новее.
- Смысловой поиск, многоуровневое сжатие и автоматическая синхронизация входят в платный Pro, 9 долларов в месяц. Бесплатная версия ищет по ключевым словам и остается рабочей без ограничения числа записей.
- Синхронизация между машинами требует собственного аккаунта Cloudflare и развернутого там Worker.
- Хуки плагина для Claude Code запускают команды `nmem-hook-*` при старте сессии, перед сжатием контекста, при остановке и после вызова инструмента. Тайм-аут хуков составляет от 10 до 30 секунд.
Как отключить. В Claude Code отключите плагин командой `/plugin` и уберите запись `neural-memory` из конфигурации MCP в других клиентах. Пакет удаляется командой `pip uninstall neural-memory`. Локальные базы памяти лежат отдельно и удаляются вручную.
Частые вопросы
Как поставить NeuralMemory в Claude Code?
Выполните `/plugin marketplace add nhadaututtheky/neural-memory`, затем `/plugin install neural-memory@neural-memory-marketplace`. Плагин подключает MCP-сервер, три скилла и хуки сессии.
Как подключить NeuralMemory к Cursor или Windsurf?
Поставьте пакет командой `pip install neural-memory` и добавьте в MCP-конфигурацию редактора сервер `neural-memory` с командой `nmem-mcp`. Инициализация проходит при первом обращении, команда `init` не нужна.
Нужны ли для работы эмбеддинги и ключи API?
Нет. Бесплатная версия работает без вызовов LLM и без эмбеддингов. Поиск идет по графу связей и по ключевым словам. Локальные и облачные модели эмбеддингов подключаются отдельными дополнениями пакета.
Чем платный Pro отличается от бесплатной версии?
Pro меняет хранилище на InfinityDB и добавляет смысловой поиск, сжатие в пять уровней и автоматическую синхронизацию. Лицензия активируется командой `nmem shared activate`, все бесплатные инструменты остаются рабочими.
Где хранятся данные и как перенести их на другой компьютер?
По умолчанию память лежит в локальной базе SQLite. Для переноса команда `nmem sync` синхронизирует ее через Worker в вашем аккаунте Cloudflare, а `nmem brain export -o backup.json` сохраняет копию в файл.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыСамостоятельно размещаемая долговременная память для агентов: семантический поиск, граф знаний и автоконсолидация через MCP и REST API
Долговременная память для Claude Code, Cursor и Codex: агент сохраняет решения и находит их в следующих сессиях
MCP-сервер долговременной памяти на вашем сервере: хранит предпочтения и решения между разговорами в Claude Code и Cursor
Долговременная память агента в локальных Markdown-файлах с графом связей, семантическим поиском и MCP-доступом
MCP-сервер долговременной памяти для ИИ-агентов: факты стареют по кривой забывания, связанные записи сжимаются в сводку
Плагин долгой памяти: запоминает решения, предпочтения и состояние задач между сессиями и подмешивает в запрос только нужное
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| NeuralMemory (эта карточка) | нет | не нужна | 243 | |
| Shodh-Memory | нет | ключ необязателен | 322 | один бинарный файл на Rust, работает офлайн и не вызывает языковую модель; NeuralMemory строит граф причинных связей с затуханием записей |
| Basic Memory | нет | не нужна | 4 495 | хранит память в локальных файлах Markdown со ссылками между заметками; NeuralMemory хранит граф нейронов в SQLite |
| MCP Memory Service | нет | не нужна | 2 090 | самохостинговая память с семантическим поиском и REST API; NeuralMemory ищет по графу связей без эмбеддингов |
Коротко о README
Документация начинается с идеи графа вместо векторного поиска и таблицы сравнения с RAG. Дальше идут облачная синхронизация, список возможностей, примеры команд и кода на Python, описание Pro, установка для разных клиентов и сравнение скорости с Mem0 и Cognee.