basic-memory

basic-memory

basicmachines-cov1.0.0AGPL-3.0
4.7k звёзд369 форков
Basic Memory — это MCP-сервер, который даёт AI-ассистентам долговременную память. Вместо того чтобы забывать контекст после каждого диалога, ассистент читает и пишет заметки в Markdown-файлы на вашем диске. Вы и ваш AI одновременно работаете с одной базой знаний. Сервер работает по принципу local-first: все данные остаются у вас в виде обычных текстовых файлов. Подходит для разработчиков, которые хотят, чтобы их AI-агенты (Claude, Codex, Cursor) помнили договорённости, архитектуру проектов и личные заметки между сессиями.
  • Сервер сообщества
  • Локальный запуск (stdio)
  • Python
  • Лицензия AGPL-3.0
  • Обновлён 20 ноября 2026 г.
Подключение

Подключить basic-memory

Выберите способ запуска и свой MCP-клиент. Ниже останется одна готовая инструкция, которую можно проверить и скопировать.

1

Способ подключения

2

Куда подключить

3

Скопируйте и проверьте

Claude Desktop / Claude Code

Локальный MCP-сервер запускается этой командой из конфигурации выбранного клиента.

  1. 1.Откройте настройки MCP в Claude.
  2. 2.Добавьте сервер с указанной командой и переменными окружения.
  3. 3.Перезапустите Claude, если сервер не появился автоматически.
json
{
  "mcpServers": {
    "basic-memory": {
      "command": "uvx",
      "args": [
        "basic-memory"
      ]
    }
  }
}

Перед подключением сверьте команду с README проекта, замените шаблонные токены и предоставьте только необходимые права доступа.

Характеристики

Общее

  • СтатусСообщество
  • Разработчикbasicmachines-co
  • Версияv1.0.0
  • ЛицензияAGPL-3.0
  • Последний релиз30.10.2026
  • Активность источника20.11.2026

Технологии

  • Языки
    Python
  • Транспорт
    stdio — локальный запуск

Описание

Возможности

  • Хранит все заметки в виде Markdown-файлов в локальной файловой системе
  • Синхронизирует записи между человеком и AI-ассистентом в обе стороны (bi-directional sync)
  • Строит граф знаний на основе наблюдений (observations) и вики-ссылок (wikilinks)
  • Выполняет семантический поиск по смыслу, а не по ключевым словам
  • Работает с любыми MCP-клиентами: Claude Desktop, Codex, Cursor, ChatGPT и другими
  • Использует прогрессивное обнаружение инструментов (progressive tool discovery) с подсказками read-only, destructive и idempotent
  • Поддерживает опциональную облачную синхронизацию между устройствами

Как подключить

Установите сервер через пакетный менеджер uv:

uvx basic-memory

Или через pip:

pip install basic-memory

Добавьте конфигурацию в файл claude_desktop_config.json:

{ "mcpServers": { "basic-memory": { "command": "uvx", "args": ["basic-memory"] } } }

После добавления перезапустите Claude Desktop. Сервер автоматически создаст директорию для заметок и будет готов к работе.

Примеры запросов

  • «Запомни, что мой текущий проект использует FastAPI и PostgreSQL. Запиши это в заметку "Проекты".»
  • «Найди все заметки, связанные с архитектурой микросервисов, и покажи граф связей между ними.»
  • «Дополни заметку "Идеи" новыми предложениями, которые мы только что обсуждали.»
  • «Покажи содержимое заметки "Roadmap Q4" и добавь в неё пункт "Интеграция с новым API".»

Технические детали

  • Язык разработки: Python
  • Транспортный протокол: stdio (стандартный ввод-вывод)
  • Лицензия: AGPL-3.0 (бесплатная версия для самостоятельного развёртывания)
  • Совместимые клиенты: Claude Desktop, Codex, Cursor, ChatGPT, любой MCP-клиент

Поделиться