basic-memory — MCP-сервер для Claude Code: заметки в Markdown
Локальный MCP-сервер, который хранит знания в Markdown-файлах на диске и даёт ИИ читать, писать и искать их. Пригодится, если надоело каждый раз объяснять агенту контекст проекта.
claude mcp add basic-memory -- uvx basic-memoryЧто делает basic-memory
Basic Memory работает с обычными Markdown-файлами на вашем диске. Агент и человек пишут в одни и те же заметки, а синхронизация держит их в согласии. Наблюдения и вики-ссылки складываются в граф знаний, поэтому контекст накапливается, а не теряется между сессиями.
Поиск идёт по смыслу, а не только по ключевым словам; для векторных и гибридных результатов есть опциональный cross-encoder реранкинг. Каждый инструмент помечен подсказками о поведении — только чтение, разрушительный, идемпотентный — так агент выбирает нужный инструмент, не тратя контекст на пробы. Есть и облачный вариант с синхронизацией между устройствами, но он не обязателен.
Для локальной установки нужен Python через uv. Ставьте так: uv tool install basic-memory --prerelease=allow. Флаг --prerelease=allow обязателен: версия 0.23 зависит от пре-релиза FastMCP 4, и без флага uv молча поставит более старый выпуск. Для развёртываний на Postgres с векторами в Milvus есть отдельный extra: uv tool install "basic-memory[milvus]" --prerelease=allow.
Какие задачи решает
- поднять граф заметок из Markdown-файлов на диске
- найти заметку по смыслу, а не по точному слову
- дать агенту доступ к прошлым сессиям и решениям
- вести общий журнал правок человека и ИИ в одних файлах
- синхронизировать заметки между устройствами через облако
Примеры запросов агенту
- Найди в моих заметках всё про деплой этого сервиса
- Запиши в basic-memory решение по схеме авторизации
- Покажи связи между заметками о миграции базы
Как установить basic-memory
Командой платформы
claude mcp add basic-memory -- uvx basic-memoryuvx запускает команду с именем пакета; если в README она другая — uvx --from basic-memory <команда>
Командой платформы
codex mcp add basic-memory -- uvx basic-memoryuvx запускает команду с именем пакета; если в README она другая — uvx --from basic-memory <команда>
Файл настроек
{
"mcpServers": {
"basic-memory": {
"command": "uvx",
"args": [
"basic-memory"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from basic-memory <команда>
Файл настроек
{
"servers": {
"basic-memory": {
"type": "stdio",
"command": "uvx",
"args": [
"basic-memory"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from basic-memory <команда>
Командой платформы
gemini mcp add basic-memory uvx basic-memoryuvx запускает команду с именем пакета; если в README она другая — uvx --from basic-memory <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о basic-memory
Как установить basic-memory в Claude Code?
Сначала поставьте пакет: uv tool install basic-memory --prerelease=allow. Затем добавьте сервер командой claude mcp add basic-memory -- uvx basic-memory.
Что делает basic-memory?
Хранит ваши знания как Markdown-файлы и даёт ИИ-клиенту читать, писать и искать их через MCP. Человек и агент работают с одними и теми же файлами.
Почему нужен флаг --prerelease=allow?
Версия 0.23 опирается на пре-релиз FastMCP 4. Без этого флага uv поставит более старую версию, и сервер не заработает как ожидается.
