Semurg agent memory — MCP-сервер памяти для агентов
Память для ИИ-агентов на своём железе: граф знаний и векторы на одном движке. Ставится одним скриптом на Linux, агент подключается по MCP.
Открыть на GitHubЧто делает Semurg agent memory
Сервер хранит заметки и документы, которые вы отдаёте агенту, режет их на пассажи и связывает с сущностями, уже лежащими в базе. Сущности и связи агент передаёт сам в том же вызове записи: по словам авторов, он делает это точнее, чем локальная модель на CPU узла. Пассажи индексируются для векторного поиска, если на узле есть модель эмбеддингов. Скоуп задаёт пространство имён: агенты на одном узле с общим скоупом видят одни факты, чужой скоуп закрыт.
Узел требует процессор x86_64 с AVX2 или новее, не меньше 2 потоков CPU и 4 ГБ памяти. Ставится на Ubuntu 24.04 установщиком, на остальном x86_64 Linux — в Docker. Сборок под Mac, Windows и ARM пока нет. Данные должны лежать на локальной файловой системе ext4 или xfs, иначе установщик остановится. Установка идёт от root и заканчивается баннером с API-токеном; лицензионный ключ для одного узла не нужен.
Для Claude подключение пишется через claude mcp add-json в пользовательский скоуп и хранит ссылку на переменную SEMURG_API_TOKEN, а не сам токен. Остальные клиенты ходят на POST /v1/mcp по streamable HTTP с заголовком Authorization: Bearer <token> и необязательным X-Semurg-Scope. Проверить, что шлюз закрыт, можно через curl на /v1/whoami: без токена ответ 401, с токеном 200.
Какие задачи решает
- держать общую память нескольких агентов на одном узле
- связать сохранённый текст с уже известными сущностями и связями
- искать по заметкам с помощью векторов без внешнего сервиса
- разделить память между конечными пользователями одного приложения
- проверить, что MCP-эндпоинт не отдаёт данные без токена
Примеры запросов агенту
- Сохрани эту заметку и передай сущности с фактами в том же вызове
memory_remember - Посмотри
memory_statusдля скоупаdefaultи покажи типы сущностей - Найди в памяти всё про деплой и процитируй пассаж, откуда взят ответ
Как установить Semurg agent memory
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Semurg agent memory
Как установить Semurg agent memory в Claude Code?
Сначала поставьте узел на Linux: curl -fsSL https://one.semurg.io/install | sudo bash, затем возьмите токен из баннера. Потом выполните export SEMURG_API_TOKEN=<токен> и `claude mcp add-json --scope user semurg '{"type":"http","url":"http://127.0.0.1:4000/v1/mcp","headers":{"Authorization":"Bearer ${SEMURG_API_TOKEN}","X-Semurg-Scope":"default"}}'`.
Что делает Semurg agent memory?
Даёт агенту долговременную память: принимает текст и факты, связывает пассажи с сущностями в графе и ищет по ним. Все вызовы идут через MCP по streamable HTTP.
Что нужно для запуска узла?
Процессор x86_64 с AVX2, минимум 2 потока CPU и 4 ГБ памяти, локальный диск на ext4 или xfs. На Ubuntu 24.04 хватает установщика, на другом Linux нужен Docker; установка выполняется от root.
