shodh-memory

shodh-memory — MCP-сервер сообщества (автор — varun29ankuS). Когнитивная память агента с графом знаний. Ставится через npx или через Docker. Лицензия Apache-2.0.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
varun29ankuS
Лицензия
Apache-2.0
Транспорт
stdio
Авторизация
api_key
ОС
Не указана
Языки
rust

Уровень риска: high

Хранит память на диске, хуки автоматически сохраняют контекст сессий; сервер слушает порт 3030; при первом запуске скачивает модели.

Настройка клиентов

cursor
{
    "code": "{\n  \"mcpServers\": {\n    \"shodh-memory\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@shodh/memory-mcp\"]\n    }\n  }\n}",
    "lang": "json",
    "notes": "Дословно из README для Cursor и Claude Desktop",
    "verified": "docs"
}

Что умеет

Shodh-Memory — постоянная память для ИИ-агентов и роботов под лицензией Apache-2.0, которая работает без вызовов языковой модели. Часто используемые воспоминания находятся легче, старый неактуальный контекст постепенно угасает, а вспоминание одного тянет за собой связанное. Подходит для чат-агентов (MCP и HTTP), роботов (Zenoh и ROS2) и периферийных устройств.

Ни запись, ни поиск не обращаются к языковой модели — всё считается локально:

  • локальные эмбеддинги MiniLM через ONNX Runtime и локальное переранжирование кросс-энкодером, включённое по умолчанию;
  • локальное распознавание сущностей GLiNER с запасным вариантом на правилах;
  • граф знаний с типизированными связями (LocatedIn, WorksAt, Causes и другие), построенный из обычного текста;
  • поиск первопричин обходом причинных связей в графе;
  • динамика памяти: усиление связей при использовании, угасание, распространение активации; память делится на рабочую, сессионную и долговременную (RocksDB).

По README запись занимает 55–60 мс в ядре, семантический поиск без переранжирования — 34–58 мс, бинарный файл весит около 17 МБ, видеокарта не нужна.

MCP-сервер даёт 51 инструмент: память (remember, recall, forget и другие), поиск и сводки, факты и сессии, задачи в стиле GTD с подзадачами и комментариями, проекты, напоминания, а также системные инструменты — статистика, проверка и починка индекса, резервные копии и восстановление.

Кому подойдёт

  • Пользователям Claude Code и Cursor, которым нужно, чтобы агент помнил контекст между сессиями без облачных сервисов.
  • Разработчикам роботов на ROS2, которым нужна память между миссиями.

Похожие серверы — в категории знания и память.

Установка

Единый CLI скачивается со страницы релизов GitHub или ставится через Homebrew. Основные команды: shodh init (первичная настройка, создание ключа API и загрузка модели), shodh server (сервер памяти на порту 3030), shodh tui (панель в терминале), shodh doctor (диагностика). Для продакшена есть образ Docker:

docker run -d -p 3030:3030 -v shodh-data:/data varunshodh/shodh-memory

Пакет @shodh/memory-mcp при подключении сам скачивает серверный бинарный файл. Для локальной работы ключ API не нужен — он создаётся автоматически; для удалённого сервера передайте SHODH_API_KEY в блоке env. Переменная SHODH_OFFLINE=true запрещает загрузку моделей.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

claude mcp add shodh-memory -- npx -y @shodh/memory-mcp

Этот JSON README приводит для Cursor и Claude Desktop. Для Claude Code можно дополнительно включить хуки автоматического сохранения контекста командой npx @shodh/memory-mcp setup-hooks.

Проверка

Выполните shodh status, чтобы проверить сервер. Затем попросите агента запомнить факт, начните новую сессию и спросите о нём — например, через инструмент what_i_know.

Примеры задач

Запомни, что сборка падает из-за устаревшей версии OpenSSL, а решение — обновить базовый образ.
Что ты знаешь о проблемах сборки? Найди первопричину и связанные задачи.

Риски

  • Запись на диск и хуки. Сервер хранит память локально, а setup-hooks устанавливает хуки Claude Code, которые автоматически сохраняют контекст каждой сессии. Помните, что в память может попасть всё, что обсуждалось.
  • Сетевой сервер. Сервер памяти слушает порт 3030. При развёртывании на общем сервере используйте ключ SHODH_API_KEY и не открывайте порт наружу без защиты.
  • Загрузка моделей. При первом запуске скачиваются модели распознавания сущностей и переранжирования; в закрытых средах включите SHODH_OFFLINE=true.
  • Удаление данных. Инструменты forget, purge_facts и восстановление из копии меняют или стирают память — делайте резервные копии через backup_create.

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

Нужен ли ключ OpenAI или другой внешний сервис?

Нет. Запись и поиск не вызывают языковую модель, всё работает офлайн на вашем компьютере.

Чем это отличается от mem0 или Zep?

По сравнению из README, Shodh-Memory не делает вызовов языковой модели при записи, не требует внешних сервисов, учится на использовании и забывает неактуальное.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

Memory

Эталонный сервер постоянной памяти на основе графа знаний.

Риск: high Лицензия: NOASSERTION ★ 92 089

Context7

Context7 даёт агентам актуальную документацию и примеры кода библиотек нужных версий.

Риск: medium Лицензия: MIT ★ 65 087

hindsight

Долговременная память для ИИ-агентов по образцу человеческой.

Риск: medium Лицензия: MIT ★ 61 836

cognee-mcp

Менеджер памяти cognee для ИИ-приложений на графовых и векторных хранилищах.

Риск: high Лицензия: Apache-2.0 ★ 33 236

Источники