mcp-memory-keeper
A local MCP server using SQLite to unify context and memory across multiple AI agents, enabling persistent decisions and preferences without re-explanation.
README
Unified Agent Context
여러 AI 에이전트(claude code, codex, hermes, gajaecode, lettacode, …)의 컨텍스트/메모리를 하나의 로컬 공유 저장소로 통합하는 v1 시스템.
목표 한 줄: 어느 에이전트에서 정한 결정·선호도 재설명 없이 모든 에이전트의 새 세션에 이어진다.
아키텍처 (v1, 로컬 전용)
에이전트들 ──(MCP stdio)──► mcp-memory-keeper (공유 SQLite, channel=스코프 서버측 필터)
│ ▲
│ └─ 세션 시작: 증류된 사실만 주입 (훅 또는 지시 pull) — scripts/inject-context.mjs
└──── 세션 중 명시 기록 (record-fact) / 종료 자동 증류 (distill-session)
└─ 모든 저장 경로는 중앙 fail-closed 비밀 게이트 경유 (차단 or redact)
- 스코프:
global(선호) vsproject:<git-root-basename>(결정/작업 상태) — 프로젝트 간 누출 차단 (서버 쿼리 강제) - TTL: decision/preference 영구 보존, project_state 90일
- 원본 대화는 콜드 아카이브만 (주입 금지, 비밀은 redact-only)
- degraded mode: 서버 부재 시 warning/log/health/metric 4증거 방출,
UAC_STRICT=1이면 실패 처리 - v2 예정: 셀프호스팅 원격 MCP + 인증 → claude.ai 합류 / P3 작업 이어받기 / GJC 확장 자동주입
문서
| 문서 | 내용 |
|---|---|
docs/phase0-comparison.md |
저장소 후보 대조표 + 채택 근거 |
docs/phase1-storage.md |
스키마/스코프/TTL/비밀 게이트 |
docs/phase2-hooks.md |
하네스 5종 배선 + degraded mode |
docs/phase3-write-paths.md |
기록 경로 5종 + 증류/검역 |
docs/phase4-coverage-matrix.md |
20경로 커버리지 매트릭스 + 검증 계층 |
docs/onboarding.md |
신규 에이전트 합류 절차 (5분) |
주요 커맨드
node scripts/inject-context.mjs [--cwd <dir>] # 공유 컨텍스트 블록 출력
node scripts/record-fact.mjs --type decision "..." # 명시 기록 (비밀은 exit 3 차단)
node scripts/distill-session.mjs --file <transcript> # 세션 증류 + 검역 스윕
node scripts/doctor.mjs # 배선 자가진단
node scripts/cross-verify.mjs # 20경로 커버리지 매트릭스 재실행
node scripts/reexplain.mjs log|report # 재설명 계측 (2주 관문 보조지표)
node --test 'tests/*.test.mjs' # 전체 테스트 (65+)
2주 실사용 관문 (진행 중)
시나리오 테스트는 전부 통과 상태. 최종 합격은 2주 실사용에서 "다시 설명하는" 체감이 사라졌는지 사용자 확인으로 판정한다. 재설명이 발생할 때마다 reexplain.mjs log로 기록하고, 2주 후 report의 주간 추이가 0에 수렴하는지 본다.
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.