MCP Memory Keeper의 개요
MCP Memory Keeper는 코딩 에이전트가 하고 있는 일을 키가 붙은 컨텍스트 항목(작업, 결정, 진행 메모)으로 저장하며, 각 항목에는 범주, 우선순위, 채널이 붙습니다. 저장 위치는 ~/mcp-data/memory-keeper/context.db의 로컬 SQLite 데이터베이스입니다. 이름 붙은 체크포인트는 이 항목들과 캐시된 파일 내용, git 상태를 스냅샷으로 남기고, Claude Code가 압축하거나 재시작한 뒤에는 context_restore_checkpoint가 이를 되살립니다. 채널은 기본적으로 git 브랜치에서 만들어지므로, feature/auth-system은 최대 20자의 채널이 됩니다.
서버는 기본적으로 stdio로 38개의 도구를 제공합니다. context_save, context_get, context_search부터 세션 분기, 일지 항목, 지식 그래프, context_git_commit 도구까지 있습니다. TOOL_PROFILE 변수로 이를 8개(minimal)나 22개(standard)로 줄일 수 있습니다. 설치는 claude mcp add memory-keeper npx mcp-memory-keeper이며, 계정이나 키는 필요 없습니다.
저장소는 2025년 6월 Mark Kreyman이 만들었고, MIT 라이선스이며 스타는 약 136개입니다. 커밋은 거의 모두 관리자 한 명이 했습니다. 최신 npm 버전은 2026년 9월 2일의 0.14.1이고(GitHub 릴리스는 v0.12.1에서 멈춰 있습니다), 10월 22일까지 한 주 동안 패키지 다운로드는 140회였습니다. 공식 MCP 레지스트리에는 올라 있지 않습니다.
MCP Memory Keeper 설치 방법
claude mcp add memory-keeper npx mcp-memory-keeperMCP Memory Keeper, 쓸 만한 가치가 있습니까?
Memory Keeper는 긴 에이전트 세션의 실제 문제를 중심으로 만들어졌습니다. 컨텍스트 창이 압축되면 결정과 반쯤 끝난 계획이 사라진다는 문제입니다. 해법은 자동이 아니라 의도적입니다. README가 제시하는 작업 흐름에서는 대화가 길어지면 Claude에게 체크포인트를 저장하라고 하고, 초기화 뒤에 키로 복원하라고 요청합니다. 압축에 자동으로 연결되는 기능은 없으며, 다시 불러오는 일은 CLAUDE.md의 지시나 사용자 정의 명령에 달려 있습니다.
가장 큰 비용은 도구 목록입니다. 기본 full 프로필은 38개의 도구를 나열하며, 모델은 매 턴마다 각 도구의 스키마를 읽습니다. 참조 구현인 memory 서버가 아홉 개로 해내는 일입니다. 관리자는 프로필로 이를 인정합니다. minimal은 8개(세션, 저장, 조회, 검색, 상태, 체크포인트 도구 두 개)를 남기며, 대부분은 여기서 시작해야 합니다. 버전 0.12.2에서는 full 프로필이 OpenAI 호환 제공업체를 깨뜨리던 문제도 고쳤는데, 기능 범위가 얼마나 퍼졌는지 보여 주는 신호입니다.
일부 기능은 이름보다 가볍습니다. context_semantic_search는 언어 모델을 쓰지 않습니다. 소스 코드를 보면 문자 트라이그램과 단어를 해시해 384개의 숫자로 된 벡터를 만들고 이를 비교하므로, 의미가 아니라 비슷한 철자를 찾습니다. 지식 그래프와 멀티 에이전트 도구도 같은 저장 텍스트를 대상으로 로컬에서 실행됩니다. 저장 방식은 더 탄탄합니다. WAL 모드의 SQLite를 쓰고, 0.12.x부터는 데이터베이스 경로가 절대 경로이며, 가져오기와 내보내기는 한 디렉터리로 제한됩니다.
보안에서 주의할 점이 두 가지 있습니다. context_git_commit은 git add .를 실행해 프로젝트 디렉터리의 모든 것을 커밋하므로, 에이전트가 커밋할 생각이 없던 파일까지 스테이징할 수 있습니다. 그런 동작을 원하지 않는다면 프로필에서 빼 두십시오. 또 버전 0.13.0(2026년 6월)은 context_import가 서버가 닿을 수 있는 어떤 파일이든 읽던 문제를 고쳤습니다. 프롬프트 인젝션을 당한 에이전트가 비밀 정보를 메모리로 끌어오는 데 쓸 수 있던 허점입니다. 수정은 반영되었지만, 관리자에게 비공개 취약점 신고를 켜 달라고 요청하는 issue가 아직 열려 있습니다.
참조 구현인 memory 서버와 비교하면, 구조를 얻는 대신 무게를 감수하는 선택입니다. memory는 읽기 쉬운 JSONL 파일 하나와 엔터티 그래프를 줍니다. Memory Keeper는 범주, 우선순위, 브랜치를 따르는 채널, 체크포인트를 sqlite3로 조회하는 데이터베이스에 담아 줍니다. 주당 npm 다운로드가 약 140회이고 관리자가 한 명인 작은 프로젝트이며, 2026년 9월까지 꾸준히 릴리스되었습니다.
제 역할을 하는 곳
Claude Code로 며칠에 걸친 리팩터링을 하는 1인 개발자
압축이나 재시작 뒤에 에이전트가 멈춘 곳에서 이어 가기
TOOL_PROFILE=minimal로 실행하고, 결정과 진행 상황을 저장하라는 규칙을 CLAUDE.md에 추가한 뒤, 창이 차기 전에 context_checkpoint를 요청합니다. 초기화 뒤에는 context_restore_checkpoint가 저장된 항목을 돌려줍니다. 무료이며, 비용은 요청하는 것을 잊지 않는 수고입니다.
조사용과 구현용으로 Claude Code 세션 두 개를 동시에 돌리는 개발자
한 세션의 조사 결과를 다른 세션에 넘기기
두 세션이 같은 DATA_DIR을 가리키게 합니다. 항목은 기본적으로 세션 사이에서 보이며, 공유 채널을 쓰면 넘겨주는 내용을 한 주제로 묶을 수 있습니다. 세션 사이에 접근 제어가 없으므로, 한쪽이 저장한 것은 무엇이든 다른 쪽이 읽을 수 있습니다.
20인 팀의 MCP 서버를 승인하는 엔지니어링 책임자
직원이 업무용 노트북에 설치해도 되는지 정하기
데이터는 로컬 SQLite 파일에 머물고 소스 코드는 자체적으로 네트워크 호출을 하지 않으므로, 평가할 처리자가 없습니다. 확인할 것은 git 커밋 도구(~/.mcp-memory-keeper/config.json의 사용자 정의 프로필로 제외), 가져오기 파일 읽기 버그가 있는 0.13.0 이전 버전, 그리고 비공개 신고 경로가 없는 1인 관리 프로젝트라는 점입니다.
도입 전 확인할 점
- 설정
- claude mcp add memory-keeper npx mcp-memory-keeper를 실행하거나 Claude Desktop 설정에 npx 스니펫을 넣습니다. README는 30초 이내라고 말합니다. DATA_DIR을 설정하지 않으면 데이터는 ~/mcp-data/memory-keeper/ 에 저장됩니다. 0.12.x 이전 버전에서 업그레이드하는 사용자는 예전 작업 디렉터리의 context.db를 옮겨야 합니다.
- 연동
- 기본 38개의 도구가 있으며 모두 context_*라는 이름입니다. context_session_start, context_save, context_get, context_search, context_checkpoint, context_restore_checkpoint, context_prepare_compaction, context_export, context_import 등이 있습니다. 대부분 데이터베이스에 쓰며, context_git_commit은 저장소에 씁니다. README의 예시는 이름 앞에 mcp_를 붙이지만, 이는 등록된 이름이 아닙니다.
- 데이터와 개인정보
- 모든 것이 SQLite 데이터베이스 하나와 내보내기 디렉터리에 있습니다. 저장된 항목은 기본적으로 세션 사이에서 공유됩니다. 에이전트가 읽는 것은 웹 페이지나 파일에서 주입된 텍스트를 포함해 무엇이든 저장되어 이후 세션에서 다시 재생될 수 있습니다. 버전 0.13.0은 context_import를 통한 임의의 로컬 파일 읽기를 고쳤습니다(#35).
- 대규모 사용 시 비용
- 무료이며 요청 한도가 없습니다. 실제 비용은 컨텍스트입니다. 매 턴마다 전체 도구 목록이 들어가고, 응답은 기본적으로 25,000 토큰으로 제한되며(MCP_MAX_TOKENS), 큰 context_get 하나가 이를 채울 수 있습니다.
- 제한
- stdio 전용이며 사용자는 한 명입니다. 압축 시점의 자동 체크포인트는 없으므로 에이전트에게 알려 줘야 합니다. 검색은 텍스트와 트라이그램 일치입니다. better-sqlite3 네이티브 모듈은 0.14.1 전까지 Node 업그레이드 뒤 불러오기에 실패했으며, README는 보존 정책과 다중 사용자 지원을 향후 과제로 올려 두었습니다.
좋은 점
- 체크포인트가 항목, 캐시된 파일, git 상태를 함께 담습니다
- 채널이 git 브랜치를 자동으로 따릅니다
- 도구 프로필로 38개의 도구를 8개나 22개로 줄일 수 있습니다
- 로컬 SQLite이며 계정, 키, 네트워크 서비스가 없습니다
아쉬운 점
- 기본 38개의 도구가 모든 프롬프트를 부풀립니다
- context_git_commit이 프로젝트 디렉터리 전체를 스테이징하고 커밋합니다
- '시맨틱' 검색은 임베딩이 아니라 해시한 트라이그램입니다
- 관리자가 한 명이며 주당 npm 다운로드는 약 140회입니다
추천 대상
긴 세션을 돌리면서 언제 체크포인트를 남기고 복원할지 에이전트에게 직접 알려 줄 의향이 있는 Claude Code 사용자입니다.
MCP Memory Keeper 대안
MCP Memory Keeper: 자주 묻는 질문
- MCP Memory Keeper, 쓸 만한 가치가 있습니까?
- 압축 때 작업을 잃는 문제에 대한 사려 깊은 해법입니다. 다만 38개의 도구와, 대부분의 사용자가 꺼 두어야 할 커밋 명령이 함께 딸려 옵니다. 평점은 5점 만점에 3.4점입니다.
- MCP Memory Keeper의 가격은 얼마입니까?
- 무료이며 MIT 라이선스입니다.
- MCP Memory Keeper의 단점은 무엇입니까?
- 기본 38개의 도구가 모든 프롬프트를 부풀립니다; context_git_commit이 프로젝트 디렉터리 전체를 스테이징하고 커밋합니다; '시맨틱' 검색은 임베딩이 아니라 해시한 트라이그램입니다; 관리자가 한 명이며 주당 npm 다운로드는 약 140회입니다.
- MCP Memory Keeper에 적합한 사람은 누구입니까?
- 긴 세션을 돌리면서 언제 체크포인트를 남기고 복원할지 에이전트에게 직접 알려 줄 의향이 있는 Claude Code 사용자입니다.
- 팀이나 프로덕션 환경에서 MCP Memory Keeper의 비용은 얼마입니까?
- 무료이며 요청 한도가 없습니다. 실제 비용은 컨텍스트입니다. 매 턴마다 전체 도구 목록이 들어가고, 응답은 기본적으로 25,000 토큰으로 제한되며(MCP_MAX_TOKENS), 큰 context_get 하나가 이를 채울 수 있습니다.
- MCP Memory Keeper에 회사 데이터를 맡겨도 안전합니까?
- 모든 것이 SQLite 데이터베이스 하나와 내보내 기 디렉터리에 있습니다. 저장된 항목은 기본적으로 세션 사이에서 공유됩니다. 에이전트가 읽는 것은 웹 페이지나 파일에서 주입된 텍스트를 포함해 무엇이든 저장되어 이후 세션에서 다시 재생될 수 있습니다. 버전 0.13.0은 context_import를 통한 임의의 로컬 파일 읽기를 고쳤습니다(#35).
- MCP Memory Keeper의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Memory (reference server) 및 Project RAG입니다.
답변 확인일: 2026년 10월 26일.