AtomicMemory — MCP-сервер долговременной памяти для агентов
AtomicMemory
MCP-сервер долговременной памяти для агентов: поиск, запись и исправление фактов между сессиями в облаке или в локальном ядре
- 440 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Все, что агент отправляет в `memory_ingest`, хранится у провайдера памяти и возвращается в контекст других сессий
- Установщик запускается как `curl | sh` и сохраняет проектный ключ в файле с правами владельца
- Команда `am integrate` меняет пользовательскую конфигурацию MCP выбранного агента
Установка
- Работает в
Ручная установка
curl --proto '=https' --tlsv1.2 -fsSL https://get.atomicstrata.ai/install.sh | sh -s -- --initСтавит консольный клиент `am` и запускает инициализацию облака. Загрузки сверяются с контрольными суммами.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Все, что агент отправляет в `memory_ingest`, хранится у провайдера памяти и возвращается в контекст других сессий
- Установщик запускается как `curl | sh` и сохраняет проектный ключ в файле с правами владельца
- Команда `am integrate` меняет пользовательскую конфигурацию MCP выбранного агента
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
AtomicMemory хранит долговременную память агента: предпочтения, факты и решения, которые переживают отдельные сессии. Память можно исправлять: когда факты меняются, запись заменяют, уточняют, удаляют или оставляют как есть. MCP-сервер `@atomicmemory/mcp-server` отдает агенту шесть инструментов. `memory_search` ищет по смыслу, `memory_ingest` записывает текст или сообщения, `memory_package` собирает контекст с лимитом на число токенов, `memory_list` показывает последние записи. `entity_profile` строит сводку по пользователю или агенту, а `entity_attributes` возвращает структурированные тройки «сущность, атрибут, значение». Хранилище выбирают из двух вариантов: управляемое облако AtomicMemory Cloud или открытое ядро, которое запускается локально в Docker. Подключить сервер к Cursor, Claude Code, Codex или OpenCode помогает консольный клиент `am`: команда `am integrate` записывает конфигурацию MCP выбранного агента.
Для кого. Для разработчиков, которые работают с несколькими кодовыми агентами и хотят, чтобы те помнили предпочтения, решения и факты о проекте между сессиями.
Подходит, если
- Агент забывает предпочтения и решения между сессиями, и нужен общий слой памяти для Claude Code, Cursor, Codex и OpenCode
- Запомненное нужно исправлять: заменять устаревший факт, уточнять его или удалять
- Нужен контекст под задачу с лимитом на токены: его собирает `memory_package`
- Память должна жить на вашем сервере: открытое ядро работает в Docker, а MCP-сервер поддерживает режим HTTP
- Нужен профиль пользователя или агента, собранный из накопленных записей
Не подходит, если
- Вам хватает файла с правилами проекта вроде AGENTS.md: отдельный сервис памяти избыточен
- Диалоги и факты нельзя отправлять во внешний сервис, а локальное ядро развернуть нечем: в облачном режиме записи хранит провайдер памяти
- Нужен аудит записей: ответы MCP приходят текстом с JSON внутри, поэтому для проверки читают REST API или SDK
Пример запроса к агенту
Запомни, что в перелетах я предпочитаю места у прохода, а затем найди в памяти, что я говорил про выбор местаMCP
- Транспорт
- stdio, http
- Авторизация
- ключ необязателен
Переменные окружения
ATOMICMEMORY_API_KEYсекрет- Проектный ключ API. Нужен для облака, для локального ядра по умолчанию подставляется local-dev-key.
ATOMICMEMORY_API_URL- Адрес провайдера памяти. В режиме HTTP обязателен.
ATOMICMEMORY_SCOPE_USER- Область user по умолчанию. В режиме stdio берется имя локального пользователя.
ATOMICMEMORY_MCP_TRANSPORT- Транспорт: stdio по умолчанию или http для размещаемого сервера.
Ограничения
Облачному режиму нужны проектный ключ API и аккаунт AtomicMemory Cloud. Локальный режим Connected Local требует запущенный Docker и ключ OpenAI API, а API OpenAI из России недоступен. Поддерживаются macOS и Linux с glibc на процессорах x86_64 и arm64.
Ответы инструментов приходят текстом с JSON внутри ради совместимости с клиентами. Для проверки записей авторы советуют читать REST API или SDK. Пакеты плагинов для Codex и Cursor помечены статусом «скоро», поэтому эти агенты подключают прямой настройкой MCP через `am integrate`.
Режим HTTP работает только с проектным ключом в каждом запросе, OAuth в нем нет. Сервер хранит то, что агент в него отправил, поэтому секреты, токены и закрытые ключи в память класть нельзя.
Как отключить. Удалите сервер из пользовательской конфигурации MCP вашего агента и перезапустите клиент. Записи остаются в хранилище: облачном проекте или локальном ядре.
Частые вопросы
Как подключить AtomicMemory к Claude Code?
Установите клиент `am` скриптом с get.atomicstrata.ai, пройдите `am init`, затем выполните `am integrate --yes --host claude-code`. Команда запишет пользовательскую конфигурацию MCP, а `am integrate doctor` покажет проблемы настройки.
Какие инструменты есть у MCP-сервера AtomicMemory?
Шесть: `memory_search`, `memory_ingest`, `memory_package`, `memory_list`, `entity_profile` и `entity_attributes`. Первые четыре работают с записями, два последних возвращают профиль и структурированные атрибуты.
Нужны ли Docker и ключ OpenAI?
Для облака не нужны ни то ни другое. Режим Connected Local запускает ядро в Docker и просит ключ OpenAI API, который клиент читает со скрытым вводом и хранит с правами только для владельца.
Можно ли запустить сервер без облака?
Да. Команда `npx -y @atomicmemory/mcp-server` без ключа и адреса обращается к локальному ядру по адресу `http://127.0.0.1:17350` и подставляет ключ `local-dev-key`.
Как запустить сервер по HTTP на своем хосте?
Задайте `ATOMICMEMORY_MCP_TRANSPORT=http` и `ATOMICMEMORY_API_URL`, затем запустите пакет с флагом `--http`. Каждый запрос должен нести заголовок Authorization с проектным ключом, иначе сервер ответит 401. По умолчанию он слушает порт 3100.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер долгой памяти для агентов: сжимает диалоги в атомарные факты, разрешает местоимения и привязывает время к абсолютным датам
Самостоятельный MCP-сервер долговременной памяти для агентов: структурированные записи, версии с откатом и визуальная панель
Самостоятельно размещаемая долговременная память для агентов: семантический поиск, граф знаний и автоконсолидация через MCP и REST API
iai-memory
iai-memory (Personal Memory Engine)
Локальный MCP-сервер долговременной памяти для агента: хранит разговоры дословно и возвращает нужный контекст в начале сессии
Долговременная память для агентов: удаленный MCP-сервер, плагины для Claude Code, Cursor и Codex и API для своих приложений
Локальный MCP-сервер памяти для агентов: история сессий, индекс кодовой базы и граф понятий в одной базе SQLite
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| AtomicMemory — MCP-сервер долговременной памяти для агентов (эта запись) | да | ключ необязателен | 440 | |
| Mem0 | нет | 68 007 | слой памяти для агентов с плагинами для Claude Code, Codex, Cursor и OpenCode, CLI и SDK | |
| MCP Memory Service | нет | не нужна | 2 054 | самостоятельно размещаемая память с семантическим поиском, графом знаний и автоконсолидацией |
| Basic Memory | нет | не нужна | 4 389 | память агента в локальных Markdown-файлах с графом связей |
Коротко о README
В описании есть таблицы статусов пакетов (опубликован, ожидает публикации, скоро, устарел) и раздел о границах доверия: что лежит в этом репозитории, а что остается в закрытой инфраструктуре. Результаты бенчмарков автор приводит как собственные измерения, материалы для их воспроизведения обещаны позже.