Подключите когнитивную память YantrikDB к Hermes через MCP

Как применить

Память хранится в локальном файле SQLite (по умолчанию ~/.yantrikdb/memory.db); в режиме stdio ничего не покидает ваш компьютер.

По умолчанию используйте встроенную память Hermes (MEMORY.md, USER.md, скиллы) — это оптимальный инструмент для хранения информации об идентичности, предпочтениях пользователя и процедурных знаний, которыми агент активно управляет.

Прибегайте к YantrikDB в следующих случаях:

Если вы храните тысячи фактов, а не сотни, и стоимость использования окна контекста имеет значение.

Если вам нужно автоматическое обнаружение противоречий, например, «Алиса переехала в Берлин» против более старой записи «Алиса живёт в Лондоне».

Если важно учитывать временное затухание — устаревшие воспоминания должны исчезать, если их явно не подкреплять.

Если нескольким агентам, устройствам или сессиям необходимо делиться общей памятью (режим SSE).

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

Движок YantrikDB распространяется по лицензии AGPL-3.0, а обёртка сервера MCP — по лицензии MIT. Использование движка напрямую через сервер MCP не порождает обязательств по AGPL для вашего кода, но изменение движка и его распространение таковыми являются. Если вы создаёте коммерческий продукт, ознакомьтесь с лицензией перед форком.

Это не официальная интеграция Nous: YantrikDB — сторонний проект, совместимый с Hermes, поскольку оба используют протокол MCP; поэтому при изменении клиента MCP в Hermes или сервера YantrikDB потребуется корректировка обоих компонентов.

Воспринимайте это как дополнение, а не замену: встроенная память Hermes отвечает за идентичность и стиль, а YantrikDB лучше всего подходит для хранения долгосрочных фактов, которые агент может запрашивать по мере необходимости.

В качестве более лёгкой альтернативы встроенные в Hermes skill_manage и поиск по сессиям (на основе FTS5) удовлетворяют большинству потребностей в сохранении информации между сессиями без необходимости установки дополнительного сервиса.

Режим stdio предназначен для одного компьютера и является самым простым вариантом:

pip install yantrikdb-mcp

Добавьте сервер в конфигурацию сервера MCP Hermes, обычно config.yaml в разделе mcp_servers::

mcp_servers:
  yantrikdb:
    command: yantrikdb-mcp
    # Optional: override default DB location
    env:
      YANTRIKDB_DB_PATH: /home/you/.hermes/yantrikdb.db

Перезапустите Hermes. Инструменты YantrikDB теперь появятся в разделе hermes tools.

Режим SSE позволяет разделять память между машинами — например, Hermes на VPS взаимодействует с YantrikDB на домашнем лабораторном стенде:

Запустите сервер в режиме SSE, чтобы он принимал подключения от других машин:

export YANTRIKDB_API_KEY=$(python -c "import secrets; print(secrets.token_urlsafe(32))")
yantrikdb-mcp --transport sse --port 8420

Затем укажите в конфигурации MCP Hermes адрес конечной точки SSE:

mcp_servers:
  yantrikdb:
    type: sse
    url: http://your-homelab:8420/sse
    headers:
      Authorization: Bearer YOUR_API_KEY