MCP-Memory — это MCP-сервер, который даёт AI-агентам долговременную память. С ним Claude Desktop, Cursor, Antigravity, Windsurf и Codex запоминают состояние между сессиями. Все записи хранятся в формате Open Knowledge Format (OKF v0.2) и индексируются локальным SQLite с поддержкой FTS5 full-text search. Благодаря этому поиск по ключам, тегам и тексту работает быстро — ключи находятся меньше чем за 20 мс.
Архитектура двойная. С одной стороны, каждая память автоматически выгружается на диск как обычный .md файл в каталог memory/ — там же лежат index.md и log.md для навигации и истории обновлений. С другой стороны, SQLite отдаёт высокопроизводительный поиск. Записи изолированы по namespace: например, user/preferences, project/architecture или default.
Сервер предоставляет четыре основных MCP-инструмента. Первый сохраняет или обновляет запись. Обязательные параметры: key, content, project_root. Необязательные: tags, namespace, concept_type, title, description, resource, status, stale_after, sources, verified, generated_by. Второй достаёт конкретную запись по key и namespace. Третий ищет по keywords, tags и namespace, с лимитом результата (по умолчанию 10). Четвёртый — session checkpoint: при старте сессии возвращает последний сохранённый чекпоинт system/last_memory, чтобы агент знал, где остановился, а при завершении milestone обновляет его (можно передать summary).
Каждая запись — это Markdown с YAML frontmatter: type, key, namespace, tags, generated, created_at, updated_at и другие поля. Формат строго соответствует SPEC.md и OKF_RULES.md.
Установка простая. Склонируй репозиторий, запусти python3 setup.py — скрипт сам пропишет сервер для Antigravity, Claude, Cursor, Windsurf и Codex. После этого клиент сам запускает mcp-memory в фоне. Для ручной настройки есть run.sh: его указывают в mcp_config.json, claude_desktop_config.json, ~/.codex/config.toml, либо добавляют через claude mcp add или codex mcp add.
По умолчанию память хранится в корне проекта: человекочитаемые OKF-файлы в memory/, SQLite-база в .mcp_memory/memories.db. Пути можно переопределить через MCP_MEMORY_PROJECT_ROOT, MCP_MEMORY_DB_PATH и MCP_MEMORY_DIR. Если нужен общий стор для всех проектов, задай пути вроде ~/.mcp_memory/memories.db и ~/.mcp_memory/memory. В комплекте идут автотесты — проверяют OKF-сериализацию, операции с SQLite и выполнение инструментов FastMCP.