memory-mcp

MCP-сервер долговременной памяти для OpenCode — хранит предпочтения, уроки и историю использования в одном локальном SQLite-файле (100% локально, без внешних API), чтобы ИИ мог «помнить и адаптироваться» к пользователю через контекстное обучение.

Статус: v1.1.0 — все 4 фазы реализованы, тесты проходят 70/70 утверждений (smoke 53 + capture 8 + distill 9)

ไทย / Thai: README.th.md

Архитектура

OpenCode ──┬─ Plugin learning-capture (Bun)  ── auto-captures prompts/tool/error into DB
            │                                   └─ injects profile back into context on compaction
            └─ MCP memory-mcp (Node.js stdio)  ── 9 tools read/write the same SQLite DB
                                                      ▲
                               Global instructions (memory-protocol.md) teach the AI to use the tools

Подробности см. в design.md.

Related MCP server: MCP Vector Memory

Скрипты

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

Установка с OpenCode

1. Объедините раздел mcp из opencode.example.json в ваш opencode.json (глобальный или на уровне проекта)

   • Важно: установите MEMORY_DB_PATH на ТОТ ЖЕ файл базы данных и для сервера, и для плагина (в примере используется <ABSOLUTE_PATH>/memory-mcp/data/memory.db), иначе плагин автозахвата пишет в другую БД, чем та, которую читает ИИ

   • Как это сделать (выберите один вариант):

     • определите его в environment в mcp (см. пример) — покрывает только MCP-сервер

     • или установите его как переменную окружения на уровне системы/пользователя (например, setx MEMORY_DB_PATH "D:/path/to/memory.db" в Windows) — покрывает и сервер, и плагин, так как плагин работает в том же процессе, что и OpenCode

2. Подключите глобальные правила памяти — добавьте в opencode.json:

   "instructions": ["C:/Users/<user>/.config/opencode/memory-protocol.md"]

   (пример содержимого правил находится в AGENTS.memory.example.md — можно подключить на уровне проекта вместо этого)

3. (Необязательно) Разверните плагин автозахвата: скопируйте src/plugin/learning-capture.ts → ~/.config/opencode/plugins/learning-capture.ts

4. Перезапустите OpenCode (конфигурация загружается только при запуске)

5. Тест: «Запомни, что я предпочитаю pnpm» → откройте новую сессию и спросите обратно

Повседневное использование

ИИ принимает как тайский, так и английский языки взаимозаменяемо — вы можете переключать языки в любое время без предупреждения.

Долгосрочный уход: периодически запускайте npm run distill, чтобы обобщать статистику и удалять взаимодействия старше 30 дней.

Структура data/

data/
├── memory.db          # SQLite (WAL mode) — main DB (+ .db-wal, .db-shm)
└── exports/           # JSON files from export_memory (writeable only in this dir)

• Путь к БД можно переопределить через переменную окружения MEMORY_DB_PATH

• всё в data/ игнорируется git