basic-memory

basic-memory

basicmachines-coAGPL-3.0
3.1k звёзд208 форков
Basic Memory — это MCP-сервер, который даёт AI-ассистентам долговременную память. Вместо того чтобы забывать контекст после каждого диалога, ассистент читает и пишет заметки в Markdown-файлы на вашем диске. Вы и ваш AI одновременно работаете с одной базой знаний. Сервер работает по принципу local-first: все данные остаются у вас в виде обычных текстовых файлов. Подходит для разработчиков, которые хотят, чтобы их AI-агенты (Claude, Codex, Cursor) помнили договорённости, архитектуру проектов и личные заметки между сессиями.
Ai-ml
Открыть на GitHub

Установка

uvx basic-memory

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

Общее

  • СтатусСообщество
  • Разработчикbasicmachines-co
  • ЛицензияAGPL-3.0

Технологии

  • Языки
    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-клиент

Поделиться