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; в память может попасть всё обсуждаемое. Удаление проектов выключено по умолчанию. Не записывайте в память пароли и ключи, держите папку в резервной копии.

Настройка клиентов

codex
{
    "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.

claude_desktop_config.json
{
  "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

Эталонный сервер постоянной памяти на основе графа знаний.

Риск: high Лицензия: NOASSERTION ★ 92 089

Context7

Context7 даёт агентам актуальную документацию и примеры кода библиотек нужных версий.

Риск: medium Лицензия: MIT ★ 65 087

hindsight

Долговременная память для ИИ-агентов по образцу человеческой.

Риск: medium Лицензия: MIT ★ 61 836

cognee-mcp

Менеджер памяти cognee для ИИ-приложений на графовых и векторных хранилищах.

Риск: high Лицензия: Apache-2.0 ★ 33 236

Источники