Basic Memory MCP
Долговременная память агента в локальных Markdown-файлах с графом связей, семантическим поиском и MCP-доступом
- 4 403 ★ репозитория
- Последний коммит
- AGPL-3.0
Расширенный доступ
Почему такой уровень
- Создает, меняет и удаляет файлы заметок на диске
- CLI сам обновляется в фоне при установке через uv tool или Homebrew
Установка
- Работает в
Ручная установка
claude mcp add basic-memory -- uvx --prerelease=allow basic-memory mcpДоступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Создает, меняет и удаляет файлы заметок на диске
- CLI сам обновляется в фоне при установке через uv tool или Homebrew
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Basic Memory хранит знания в обычных Markdown-файлах, которые читают и пишут и человек, и агент. Каждая заметка содержит наблюдения по категориям и связи через вики-ссылки, из них строится граф, по которому агент восстанавливает контекст в новой сессии. Сервер дает инструменты для записи, чтения, правки и поиска заметок, навигации по графу, управления проектами и проверки структуры базы. Поиск бывает полнотекстовым, векторным и гибридным, индекс лежит в локальной SQLite. Есть плагин для Claude Code с брифингом в начале сессии и сохранением перед сжатием контекста.
Для кого. Для тех, кто ведет долгие проекты с агентом и не хочет каждый раз заново объяснять контекст.
Подходит, если
- Нужно, чтобы агент помнил решения и выводы между сессиями
- Нужна база знаний, которую можно открыть в Obsidian или редакторе
- Нужно работать с одними заметками из Claude, Codex и Cursor
Не подходит, если
- Хватает встроенных файлов памяти агента вроде CLAUDE.md
- Лицензия AGPL не подходит для вашего сценария распространения
Пример запроса к агенту
Запиши заметку о наших архитектурных решениях и свяжи ее с заметкой про авторизациюMCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Переменные окружения
BASIC_MEMORY_NO_PROMOS- Отключает промо облака и телеметрию
BASIC_MEMORY_SEMANTIC_SEARCH_ENABLED- Включает семантический поиск
BASIC_MEMORY_LOG_LEVEL- Уровень логирования
Ограничения
Локальная версия бесплатна, нужен Python через uv и флаг --prerelease=allow в командах установки. Облачная версия платная и может быть недоступна из России. CLI отправляет минимальную анонимную телеметрию, отключается переменной BASIC_MEMORY_NO_PROMOS. Лицензия AGPL-3.0.
Как отключить. Выполните claude mcp remove basic-memory или удалите блок из конфигурации MCP. Заметки остаются в папке ~/basic-memory.
Частые вопросы
Обязательно ли облако?
Нет, локальная версия работает полностью на диске, облако нужно только для синхронизации между устройствами.
Зачем флаг --prerelease=allow?
Текущая версия зависит от предрелиза FastMCP, без флага uv поставит старый выпуск.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыДолговременная память агента в папке связанных markdown-заметок, чтобы Claude Code помнил проект между сессиями
Долговременная память для ИИ-агентов: файлы Markdown как источник истины, индекс SQLite как кэш, общая у Claude Code, Codex и других
Плагин долгой памяти: запоминает решения, предпочтения и состояние задач между сессиями и подмешивает в запрос только нужное
Самостоятельно размещаемая долговременная память для агентов: семантический поиск, граф знаний и автоконсолидация через MCP и REST API
MCP-сервер долговременной памяти для агентов: один бинарник на Rust, который работает офлайн и не вызывает языковую модель
Локальная память для агентов: хранит переписку и файлы проекта дословно и находит нужное семантическим поиском через MCP
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Basic Memory (эта запись) | нет | не нужна | 4 403 | |
| Engram от Gentleman Programming | нет | не нужна | 7 679 | постоянная память для ИИ-агентов в одном бинарнике на Go |
| IWE | нет | не нужна | 1 803 | iWE хранит память проекта в связанных Markdown-заметках |
| Token Savior | нет | не нужна | 1 197 | token Savior индексирует код по символам |
Коротко о README
README сравнивает облачный и локальный варианты и дает конфигурации для Claude Desktop, Claude Code, Codex, Cursor и VS Code. Описаны плагин Claude Code, общие скиллы, интеграции с Hermes и OpenClaw. Подробно разобран формат заметок: frontmatter, наблюдения и связи. Перечислены MCP-инструменты, команды CLI, переранжирование поиска, автообновления, телеметрия и логирование. Лицензия AGPL-3.0.