memory-mcp

Локальный MCP-сервер для управления долговременной памятью агента. Память трактуется не как «сохранить и віддать», а как жизненный цикл: рождение, вспамоминание, пересмотр, оце, осасание.

Ключевая идея

Память агента бывает двух родов. Для пам-ти, у которой есть эта (ground truth), — например, индексы кода — достаточно синхрони-тации по хеышу. Но утвердаемая память без еталона (словая пользователя, решеня, урок) требет состояния, версий, до-верes and decision games. memory-mcp Обединяет их в Дво-ную структуру:

• Первоисточник — читаеме tricky и ведомый через чел markdown-файл (<store>/memories/*.мо, frontmatter-метаданые). Здесь живет сост tool жижного цикла, результат-supersede, и довери.

• Дривходнное — индек SQLite (FTS·ранжированье·реест конфликтов). Его в люб момент видел и в of sources via the com-memory_reindex.

Проект разн на Analyте трё и source: (ктстр — Трсировка обоснований — docs/design/architecture.md §12):

Related MCP server: cardloom-mcp

Принцип работы

remember ──► active ◄─────────── 본문 수정 시 자동 복귀
               │ supersede 되면 자동
               ▼
            archived ──forget(deprecate, reason 필수)──► deprecated
               │                                            │
               └────────── forget(purge, confirm 필수) ──────┘
                            (파일 삭제 — git 이력이 백스톱)

• Гейз идемPotентн конфликтов: memory_remember виdit соседн выходн, and в копле отв етa materials materials (общие сущность, разница wвn, latest_wins_eligible). The vicinal is the et с агенть-вызвателем (и пол-zovтем) — без решени нет автоперезаписи. To ignore it at events, a pair to record в pair-hash, and the palace.

• Оседaние: стареюius and usт-требов... as they " выцvested predators on the орech — `score хеalty × trust × state × (1 + fresh).** канлидата на журналит...

Wait — I — Need to fix.

Let me just be careful and type final.# memory-mcp

Локальный MCP-сервер для управления долговременной памятью агента. Память трактуется не как «сохранить и выдать», а как жизненный цикл: рождение, воспоминание, пересмотр, оценка и осадание.

Ключевая идея

Память агента бывает двух видов. Для памяти, у которой есть эталон (ground truth) — например, индексы кода — достаточно синхронизации по хешу. Но утверждаемая память, у которой нет эталона (слова пользователя, решения, уроки), требует состояния, версий, доверия и шлюза принятия решений. memory-mcp объединяет её в двухслойную структуру:

• Первоисточник — человекочитаемые и управляемые через git markdown-файлы (<store>/memories/*.md, метаданные frontmatter). Здесь живут состояние жизненного цикла, цепочка supersede и доверие.

• Производное — индекс SQLite (FTS·ранжирование·реестр конфликтов). Его можно в любой момент отбросить и полностью пересобрать одним вызовом memory_reindex.

Дизайн выведен из трёх источников (трассировка обоснований — docs/design/architecture.md §12):

| Источник | Что было взято | | ----------------------------------------------------------------------------------------------------------- | | Практический анализ codebase-memory-mcp | Разделение первоисточник/производное, stat-gate→ hеш→ частичный переиндекс, честность покрытия, изоляция store=каталог | | Статья Codebase-Memory (arXiv:2603.27277) | Экономия токенов (возврат только пути+выдержки), включение доверия в производные связи, вложение путей (контенмент) | | Статья MemOS (arXiv:2507.03724) | Конечный автомат + буферный слой archived, неразрушающая supersede-версионная цепочка, ранжирование trust×state×heat | | AX workspace memory lifecycle policy | Шлюзы полномочий (запрет автоперезаписи), идемпотентность pair-hash, сигналы latest-wins, приоритет дистилляции при сжатии, словарь сущностей |

Принцип работы

remember ──► active ◄─────────── 본문 수정 시 자동 복귀
               │ supersede 되면 자동
               ▼
            archived ──forget(deprecate, reason 필수)──► deprecated
               │                                            │
               └────────── forget(purge, confirm 필수) ──────┘
                            (파일 삭제 — git 이력이 백스톱)

• Шлюз конфликтов: когда memory_remember задевает соседние воспоминания, в ответ включаются материалы для решения (общие сущности, разница во времени, latest_wins_eligible). Решение остаётся за вызывающим агентом (и пользователем) — принятие решения не отменяет автоперезапись. Найденные пары записываются через pair-hash и больше не будут повторно пододвигаться.

• Выветривание: старые и неиспользуемые воспоминания не удаляются, а оседают в ранжировании — score = {text} × Trust × state × (1 + freshness + heat). Когда memory_status предлагает старые эпизоды как кандидаты на дистилляцию (compaction), агент суммирует их в воспоминание knowledge и помечает supersede для оригиналов.

• reconcile: демона нет. В точке входа каждого вызова инструментов — stat-gate (mtime+size) → sha256 → реиндексация только изменённого. Даже если файлы были поправлены вручную, на следующем вызове происходит схождение. Если тело archived-воспоминания изменить напрямую, оно автоматически возвращается в active (свежая воля приоритетнее).

• Русский поиск: без эмбеддингов — word FTS (префикс поглощает словоизменения переносов) + trigram FTS (фразы) + LIKE-фолбек для строк ≤2 символов; всё это собирается планировщиком запроса. "보안을 끄는" ↔ "보안을 끄고" матчится.

• Честность: recall/status всегда сообщают о свежести индекса, невосканных файлах и нерешённых конфликтах. Отсутств донесения ≠ полноотреб.

Инструменты (7)

Установка

Node.js ≥ 22.5 (node:sqlite встроен — нет внешних натов зависимости).

pnpm install && pnpm build

Registration для Claude Code:

claude mcp add memory-mcp -- node /path/to/memory-mcp/dist/main.js

или через .mcp.json:

{
  "mcpServers": {
    "memory-mcp": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/memory-mcp/dist/main.js"],
      "env": { "MEMORY_MCP_ROOT": "/path/to/your/store" }
    }
  }
}

По умолчанию store — в ~/.memory-mcp/default (заменой через env MEMORY_MCP_ROOT; не вход звαкт in at at store parameter). Если хранить manage in git — предел для purge становится git history.

Формат файла воспоминаний

---
id: 01JD2K3A9FZQ4W8XVBH5T6N7RM
type: fact | preference | decision | episode | reference | knowledge
state: active | archived | deprecated
trust: user-stated | agent-inferred | imported
entities: [ads-genisys, pacing]
source: "2026-08-24 세션, 사용자 교정"
created: 2026-08-24T14:03:00Z
updated: 2026-08-24T14:03:00Z
review_after: 2026-11-01
---
# 제목 한 줄

본문. 첫 문단이 recall 발췌로 쓰인다.

<store>/dictionary.md — нормализует формы сущностей (- стандарта: описание в (aka: синони, сокращения или)).

Разработка

pnpm typecheck   # tsc --noEmit
pnpm test        # node --test (29 tests)
pnpm lint        # biome
pnpm build       # dist/

Документы

• Архитектура: docs/design/architecture.md — принципы·рефема автомата·ная таблица от источника присл →

• Анализ/ pисходит: Практ-skodebase-memory-mcp · [Памят-Code-пам] (docs/analyze/codebase-memory-paper-analyze.md) · Памяти MemOS

License

MIT