memory-mcp

OpenCode용 장기 기억 MCP 서버 — 기본 설정, 교훈, 사용 기록을 단일 로컬 SQLite 파일에 저장합니다(100% 로컬, 외부 API 없음). 이를 통해 AI는 컨텍스트 기반 학습을 통해 사용자를 "기억하고 적응"할 수 있습니다.

상태: v1.1.0 — 4단계 모두 구현, 테스트 70/70 어서션 통과 (smoke 53 + capture 8 + distill 9)

ไทย / Thai: README.th.md

Architecture

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

Scripts

Tools (9)

Install with OpenCode

1. opencode.example.json의 mcp 섹션을 opencode.json(전역 또는 프로젝트 수준)에 병합하세요.

   • 중요: 서버와 플러그인 모두에 대해 MEMORY_DB_PATH를 동일한 데이터베이스 파일로 설정하세요 (예제는 <ABSOLUTE_PATH>/memory-mcp/data/memory.db를 사용합니다). 그렇지 않으면 자동 캡처 플러그인이 AI가 읽는 DB와 다른 DB에 씁니다.

   • 설정 방법 (하나 선택):

     • mcp environment에 정의 (예제 참조) — MCP 서버에만 적용됩니다.

     • 또는 시스템/사용자 수준 환경 변수로 설정 (예: Windows에서 setx MEMORY_DB_PATH "D:/path/to/memory.db") — 서버와 플러그인 모두에 적용됩니다. 플러그인은 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을 선호한다는 것을 기억해" → 새 세션을 열고 다시 물어보세요.

Daily usage

AI는 태국어와 영어를 모두 상호 교환적으로 받아들입니다 — 언제든지 경고 없이 언어를 전환할 수 있습니다.

장기 관리: 가끔 npm run distill을 실행하여 통계를 요약하고 30일보다 오래된 상호작용을 정리하세요.

data/ structure

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

• DB 경로는 MEMORY_DB_PATH 환경 변수로 재정의할 수 있습니다.

• data/의 모든 것은 git에서 무시됩니다.