Basic Memory

Что умеет сервер

Basic Memory — проект компании Basic Machines, а не вендора крупной платформы: это решение сообщества с открытым кодом под лицензией AGPL-3.0. Знания лежат в Markdown-файлах. Каждый файл — сущность с наблюдениями (факты с категориями в квадратных скобках) и связями (вики-ссылки на другие заметки), из которых получается граф, по которому модель может переходить от заметки к заметке. Поиск работает и по ключевым словам, и по смыслу (семантический поиск), есть необязательное переранжирование результатов.

Набор инструментов включает создание, чтение, правку, перенос и удаление заметок, поиск и просмотр недавней активности, построение контекста по адресам memory://, управление проектами и проверку структуры базы знаний. Каждый инструмент размечен подсказками о поведении: только чтение, разрушающий, идемпотентный. Заметки открываются в Obsidian или любом редакторе без отдельной настройки.

Когда использовать

Сервер подойдёт, если вам нужна память ассистента, которую вы сами читаете и дополняете: журнал решений по проекту, конспекты, рабочие знания. Вы можете попросить модель оформить обсуждение заметкой, а в следующей сессии она продолжит с того места, где остановились. Для Claude Code в репозитории есть отдельный плагин с брифингами в начале сессии и сохранением состояния перед сжатием контекста.

Ограничения и безопасность

Локальная версия бесплатна, данные остаются на диске, а индекс — локальная база SQLite. Для установки нужен Python через uv. Есть и платная облачная версия с синхронизацией между устройствами: она необязательна, а заметки можно экспортировать обратно в Markdown.

Агент может записывать, править и удалять заметки в ваших проектах, поэтому держите резервную копию или храните заметки под контролем версий. README описывает минимальную анонимную телеметрию об облачных предложениях и входах в облако, в неё не входят содержимое заметок и названия. Отключить её можно переменной BASIC_MEMORY_NO_PROMOS=1. Из-за флага --prerelease=allow при установке подтягиваются предварительные версии зависимостей.

Установка

Нужен менеджер пакетов uv. Флаг --prerelease=allow обязателен: без него uv молча поставит более старую версию.

uv tool install basic-memory --prerelease=allow

Claude Desktop

Добавьте в claude_desktop_config.json (в macOS он лежит в ~/Library/Application Support/Claude/) и перезапустите Claude Desktop. Заметки по умолчанию хранятся в ~/basic-memory.

{
  "mcpServers": {
    "basic-memory": {
      "command": "uvx",
      "args": ["--prerelease=allow", "basic-memory", "mcp"]
    }
  }
}

Claude Code

claude mcp add basic-memory -- uvx --prerelease=allow basic-memory mcp

Плагин Claude Code с брифингами и командами /basic-memory:* ставится отдельно, после подключения сервера:

bm install claude-code

Codex CLI

Добавьте в ~/.codex/config.toml:

[mcp_servers.basic-memory]
command = "uvx"
args = ["--prerelease=allow", "basic-memory", "mcp"]

Cursor

Добавьте в .cursor/mcp.json (проект) или ~/.cursor/mcp.json (глобально):

{
  "mcpServers": {
    "basic-memory": {
      "command": "uvx",
      "args": ["--prerelease=allow", "basic-memory", "mcp"]
    }
  }
}

VS Code

Добавьте в пользовательские настройки (JSON):

{
  "mcp": {
    "servers": {
      "basic-memory": {
        "command": "uvx",
        "args": ["--prerelease=allow", "basic-memory", "mcp"]
      }
    }
  }
}