Zengram MCP
MCP-сервер и API общей памяти для нескольких агентов: факты, решения и события хранятся в одной базе с поиском по смыслу.
- 64 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Записи памяти хранятся на вашем сервере, а текст уходит провайдеру эмбеддингов.
- Любой агент с ключом читает и меняет общую память.
Установка
- Работает в
Ручная установка
npm install -g @zensystemai/zengram-mcpСтавит MCP-сервер; сам сервис памяти поднимают через `docker compose up -d`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Записи памяти хранятся на вашем сервере, а текст уходит провайдеру эмбеддингов.
- Любой агент с ключом читает и меняет общую память.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Zengram дает нескольким агентам на разных машинах одну память: Claude Code на ноутбуке записывает факт, автономный агент на сервере его вспоминает. Память типизирована: события неизменяемы, факты перезаписываются по ключу, статусы отражают текущее состояние, решения хранят выбор и доводы. У каждого типа свои правила жизни и затухания. Все записи лежат в одной базе Postgres с pgvector для поиска по смыслу. Сервис запускается через Docker Compose и слушает REST на порту 8084 с ключом `X-Api-Key`. MCP-сервер дает 13 инструментов, среди них `brain_store`, `brain_search`, `brain_briefing` и `brain_query`. Есть и скилл `/sessionend` для итогов сессии, и bash-обертка.
Для кого. Командам, которые запускают несколько агентов на разных машинах и хотят общую долговременную память вместо отдельного контекста у каждого.
Подходит, если
- Агент разработки записывает факт о порте сервиса, а агент задач на сервере находит его поиском.
- Новая сессия получает сводку командой `brain_briefing`.
- Решения и их причины хранят отдельным типом записей, а не в чате.
- Память экспортируют и импортируют между окружениями.
Не подходит, если
- Нужна память для одного агента на одной машине без своего сервера.
- Нельзя поднимать Postgres и Docker.
- Записи нельзя отправлять провайдеру эмбеддингов.
Пример запроса к агенту
Запомни в Zengram, что API слушает порт 8084, а затем найди эту запись поиском по смыслу.MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
BRAIN_API_URLобязательная- Адрес сервиса памяти, по умолчанию http://localhost:8084.
BRAIN_API_KEYобязательная, секрет- Ключ доступа к сервису памяти.
Ограничения
Нужен собственный сервер: Docker Compose поднимает Postgres и сервис. В `.env` задают `BRAIN_API_KEY` и ключ провайдера эмбеддингов, поэтому текст записей уходит этому провайдеру. MCP-сервер требует Node.js версии 20 или новее и две переменные, `BRAIN_API_URL` и `BRAIN_API_KEY`. Общая память доступна всем агентам с ключом, поэтому секреты в нее не складывайте и защитите порт 8084. Скилл `/sessionend` копируется в `.claude/skills/` проекта вручную.
Как отключить. Удалите запись `zengram` из конфигурации MCP, остановите стек командой `docker compose down` и при необходимости удалите том базы с накопленной памятью.
Частые вопросы
Как подключить MCP-сервер?
Установите `npm install -g @zensystemai/zengram-mcp` либо укажите в `mcpServers` команду `node` и путь к `mcp-server/src/index.js`, задав `BRAIN_API_URL` и `BRAIN_API_KEY`.
Какие типы памяти есть?
События, факты, статусы и решения. События неизменяемы, а факты по одному ключу заменяют старые.
Как проверить, что сервис работает?
Выполните `curl http://localhost:8084/health` после `docker compose up -d`.
Какие инструменты дает MCP-сервер?
Тринадцать, в том числе `brain_store`, `brain_search`, `brain_briefing`, `brain_query`, `brain_stats` и `brain_export`.
Что за скилл sessionend?
Каталог `adapters/claude-code/sessionend/` копируют в `.claude/skills/`, и получают ритуал `/sessionend` с итогами сессии, сохраняемыми в память.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыСамостоятельно размещаемая долговременная память для агентов: семантический поиск, граф знаний и автоконсолидация через MCP и REST API
MCP-сервер долговременной памяти на вашем сервере: хранит предпочтения и решения между разговорами в Claude Code и Cursor
Память для ИИ-агентов с тремя типами: факты, события и процедуры, которые учатся на ошибках; облако по ключу или локальная папка
BrainAPI превращает текст в граф знаний на вашем сервере и отдает агентам через MCP, REST и консоль с ответами по цепочке фактов
Самостоятельный MCP-сервер долговременной памяти для агентов: структурированные записи, версии с откатом и визуальная панель
Engram (getengram.app) — облачная память агента
Engram (getengram.app)
Удаленный MCP-сервер, который хранит переписки с агентом дословно и ищет по ним по смыслу между сессиями
Коротко о README
Проект вырос из рабочей установки, где не нашлось готового способа делить память агентов между машинами. Дальше идут типы памяти, хранилище, тесты и адаптеры.