Shodh-Memory MCP
MCP-сервер долговременной памяти для агентов: один бинарник на Rust, который работает офлайн и не вызывает языковую модель
- 316 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Хранит содержимое ваших сессий и решений на диске и поднимает локальный HTTP-сервер на порту 3030
- Хуки Claude Code сами записывают контекст сессий без отдельной просьбы
- Первый запуск скачивает бинарник и модели из сети
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/shodh-memoryОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Хранит содержимое ваших сессий и решений на диске и поднимает локальный HTTP-сервер на порту 3030
- Хуки Claude Code сами записывают контекст сессий без отдельной просьбы
- Первый запуск скачивает бинарник и модели из сети
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Shodh-Memory хранит долговременную память ИИ-агента целиком на вашей машине и не обращается к языковой модели ни при записи, ни при поиске. Сервер доступен через MCP, REST, пакет для Python и библиотеку для Rust. Записи проходят три уровня: рабочую память на 100 элементов, сессионную на 100 МБ и долговременную в RocksDB. То, чем вы пользуетесь, находится легче. Забытое со временем теряет вес, а связанные записи всплывают вместе. Сущности и связи (например, «работает в» или «причина») собираются в граф правилами и небольшими моделями на ONNX, без запросов к API. Для Claude Code есть хуки, которые сами сохраняют контекст сессий. Инструменты покрывают память, поиск, сессии, задачи и проекты, напоминания и резервные копии.
Для кого. Для разработчиков, которым нужна память между сессиями Claude Code или Cursor на своей машине, и для робототехников на ROS2.
Подходит, если
- Агент забывает решения и предпочтения между сессиями Claude Code или Cursor
- Данные нельзя отправлять в облако: сервер работает офлайн, а модели для векторов и сущностей запускаются на CPU
- Нужна запись памяти за миллисекунды без платных вызовов API на каждое сохранение
- Хочется, чтобы хуки сами сохраняли контекст сессии и возвращали его позже без явной просьбы
- Нужна память для робота или граничного устройства: есть мост на Zenoh и ROS2
Не подходит, если
- Нужна память, где факты извлекает языковая модель: здесь разбор делают правила и малые модели на ONNX
- Нужен сервис в облаке для нескольких людей без своего сервера: по умолчанию все хранится локально
- Нужна простая память в виде Markdown-файлов, которые читает человек: данные лежат в базе RocksDB
- Нельзя скачивать модели при первом запуске: векторы, сущности и переранжирование подгружаются автоматически
Пример запроса к агенту
Запомни, что в этом проекте мы используем Postgres 16 и миграции через sqlx, а в следующей сессии напомни мне это перед созданием таблицыMCP
- Транспорт
- stdio
- Авторизация
- ключ необязателен
Переменные окружения
SHODH_API_KEYсекрет- Ключ доступа к удаленному серверу. Для локального запуска создается автоматически.
SHODH_CE_RERANK- Значение 0 отключает переранжирование поиска перекрестным кодировщиком.
Ограничения
Цифры скорости измерены на конкретных машинах: запись занимает 55–60 мс, а между запусками CI разброс достигал 2,3 раза, поэтому считайте их порядком величины. При первом запуске сервер скачивает модели для векторов и сущностей и дальше выполняет их на CPU. Данные лежат в базе RocksDB, и читать их напрямую неудобно. Для общего сервера на несколько человек нужен свой хост с Docker, сервис слушает порт 3030.
Как отключить. Удалите сервер командой `claude mcp remove shodh-memory`, а хуки уберите из `.claude/settings.json`. Данные хранятся в каталоге, который вы задали при `shodh init`, их можно удалить вместе с ним. Контейнер останавливается через `docker stop`.
Частые вопросы
Как подключить Shodh-Memory к Claude Code?
Выполните `claude mcp add shodh-memory -- npx -y @shodh/memory-mcp`: пакет сам скачает серверный бинарник. Затем по желанию запустите `npx @shodh/memory-mcp setup-hooks`, чтобы контекст сохранялся автоматически.
Чем Shodh-Memory отличается от mem0, Cognee и Zep?
В сравнительной таблице автора у Shodh-Memory ноль вызовов LLM на запись, у mem0, Cognee и Zep от двух. Внешние сервисы не нужны: система работает офлайн, учится на использовании по правилу Хебба и забывает через затухание.
Нужен ли ключ API или облако?
Нет. Локально ключ создается автоматически, облако и внешняя база не нужны. Для удаленного сервера добавляется переменная `SHODH_API_KEY`.
Какие инструменты отдает сервер?
Всего 51: запись и поиск памяти, быстрые запросы и сводки, история сессий, задачи по методу GTD с комментариями, проекты, напоминания и резервные копии с проверкой и восстановлением.
Можно ли запустить сервер в Docker?
Да: `docker run -d -p 3030:3030 -v shodh-data:/data varunshodh/shodh-memory`, затем клиент подключается через `npx -y @shodh/memory-mcp`. Такой вариант подходит для общих серверов.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыСамостоятельно размещаемая долговременная память для агентов: семантический поиск, граф знаний и автоконсолидация через MCP и REST API
Локальная память для агентов в одном бинарнике на Rust: запоминает, ищет по смыслу и по слову, работает без сети и ключей
Самостоятельный MCP-сервер долговременной памяти для агентов: структурированные записи, версии с откатом и визуальная панель
MCP-сервер долговременной памяти для ИИ-агентов: факты стареют по кривой забывания, связанные записи сжимаются в сводку
iai-memory
iai-memory (Personal Memory Engine)
Локальный MCP-сервер долговременной памяти для агента: хранит разговоры дословно и возвращает нужный контекст в начале сессии
Долговременная память для агентов: удаленный MCP-сервер, плагины для Claude Code, Cursor и Codex и API для своих приложений
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Shodh-Memory (эта запись) | нет | ключ необязателен | 316 | |
| Claude-Mem | нет | 104 106 | плагин памяти только для Claude Code | |
| Basic Memory | нет | не нужна | 4 389 | хранит память в Markdown-файлах, которые читает человек |
| agent-memory | нет | 4 374 | Markdown как источник истины и SQLite как кэш, без графа и затухания |
Коротко о README
README начинается со сравнения с mem0, Cognee и Zep и описания локальных моделей. Дальше идут способы установки через CLI, Claude Code, Python, Rust и Docker, таблица задержек и список инструментов. В конце разделы про REST API, робототехнику на Zenoh и ROS2 и источники по нейронаукам.