basic-memory
basic-memory — MCP-сервер сообщества (автор — basicmachines-co). Локальная база знаний в Markdown с двусторонней синхронизацией с LLM. Ставится через npx. Лицензия AGPL-3.0.
Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- basicmachines-co
- Лицензия
- AGPL-3.0
- Транспорт
- stdio, streamable_http
- Авторизация
- none
- ОС
- linux, macos, windows
- Языки
- python
Уровень риска: high
Создаёт, меняет и удаляет Markdown-заметки в папке Basic Memory; в память может попасть всё обсуждаемое. Удаление проектов выключено по умолчанию. Не записывайте в память пароли и ключи, держите папку в резервной копии.
Настройка клиентов
{
"code": "[mcp_servers.basic-memory]\ncommand = \"uvx\"\nargs = [\"--prerelease=allow\", \"basic-memory\", \"mcp\"]",
"file": "~/.codex/config.toml",
"lang": "toml",
"notes": "Дословно из README",
"verified": "docs"
}
Что умеет
Basic Memory даёт ИИ-ассистенту долговременную память, которая хранится в обычных Markdown-файлах на вашем диске. Ассистент записывает заметки, ищет по ним и продолжает работу с того места, где остановился, — в Claude, Codex, Cursor и других клиентах MCP. Те же файлы можно читать и править самому, например в Obsidian.
- Заметки: запись, чтение, правка, перенос и удаление (
bm_write,bm_read,bm_edit,bm_move,bm_delete). - Поиск:
bm_search,bm_list,bm_find. Есть семантический поиск по смыслу, а не только по словам, с необязательным переранжированием. - Граф знаний: наблюдения и вики-ссылки между заметками складываются в контекст, который выдаёт
bm_context. - Проекты: список, создание и недавняя активность. Удаление проекта — отдельный инструмент, его нужно явно разрешить на сервере.
- Схемы: проверка, вывод и сравнение структуры заметок.
Каждый инструмент помечен подсказками MCP: только чтение, разрушительное действие, идемпотентность. Агенту проще выбрать нужный инструмент без проб. Есть облачная версия с синхронизацией между устройствами, но локальная работает без неё.
Кому подойдёт
- Тем, кто ведёт долгие проекты с ассистентом: решения, договорённости и находки не теряются между сессиями.
- Пользователям Obsidian: ассистент пишет в те же файлы и вики-ссылки, что видны в графе Obsidian.
- Тем, кому важна приватность: все данные лежат на диске, возможна работа без интернета.
Другие варианты — в категории знания и память.
Установка
Нужен uv. Установка локальной версии:
uv tool install basic-memory --prerelease=allowФлаг --prerelease=allow обязателен: версия 0.23 зависит от предварительного релиза FastMCP 4, и без флага uv молча поставит старую версию. Тот же флаг нужен в командах uvx и при обновлении. По умолчанию заметки лежат в ~/basic-memory.
Подключение к клиентам
Команда и конфиги приведены дословно из README. Общий порядок — в инструкции как подключить MCP.
{
"mcpServers": {
"basic-memory": {
"command": "uvx",
"args": ["--prerelease=allow", "basic-memory", "mcp"]
}
}
}Для VS Code README даёт конфиг с ключом mcp.servers в пользовательских настройках. Для Claude Code есть плагин с брифингами сессий и командами /basic-memory:*.
Проверка
Попросите ассистента: «Запиши заметку о том, что мы обсудили сегодня». Затем откройте ~/basic-memory — там появится Markdown-файл. В новой сессии спросите, что было сделано, — ассистент найдёт заметку через bm_search.
Примеры задач
Запиши в память решения по архитектуре, которые мы приняли сегодня.Что мы знаем о проблеме с кэшем? Найди все связанные заметки.Покажи, над чем я работал на этой неделе.Риски
Сервер создаёт, меняет и удаляет файлы заметок в папке Basic Memory. В заметки может попасть всё, что вы обсуждаете с ассистентом, включая чувствительные данные. Удаление проектов выключено, пока его явно не разрешить. README отмечает, что Codex всё равно запрашивает подтверждение для разрушительных инструментов.
Как снизить риски: держите папку заметок под контролем версий или в резервной копии, не записывайте в память пароли и ключи. Облачную синхронизацию включайте, только если согласны хранить заметки на стороне сервиса. Лицензия — AGPL-3.0.
Частые вопросы
Где хранятся данные?
В локальной версии — в Markdown-файлах на вашем диске, по умолчанию в ~/basic-memory.
Работает ли с Obsidian?
Да. Укажите Obsidian на папку заметок, и вики-ссылки и метаданные, которые пишет ассистент, появятся в графе.
Зачем флаг --prerelease=allow?
Версия 0.23 зависит от предварительного релиза FastMCP 4. Без флага uv установит старую версию.
Основы протокола — на странице что такое MCP-сервер.
Инструменты
- bm_read
- bm_search
- bm_list
- bm_context
- bm_recent
- bm_write
- bm_edit
- bm_move
- bm_delete
Похожие MCP-серверы
Memory
Эталонный сервер постоянной памяти на основе графа знаний.
Context7
Context7 даёт агентам актуальную документацию и примеры кода библиотек нужных версий.
hindsight
Долговременная память для ИИ-агентов по образцу человеческой.
cognee-mcp
Менеджер памяти cognee для ИИ-приложений на графовых и векторных хранилищах.