Memory (reference server)의 개요
Memory는 modelcontextprotocol/servers에서 아직 관리되는 7개의 참조 서버 중 하나이며, servers-archived로 옮겨지지 않았습니다. 모델이 알게 된 것을 작은 지식 그래프로 저장합니다. 엔터티(사람, 프로젝트), 엔터티 사이의 방향이 있는 관계, 각 엔터티에 붙는 짧은 텍스트 관찰 내용으로 이루어집니다. 9개의 도구가 이 기록을 만들고, 읽고, 검색하고, 삭제하며, 그래프 전체는 memory://knowledge-graph 리소스로도 노출됩니다.
그래프는 MEMORY_FILE_PATH로 지정하는 로컬 JSONL 파일 하나에 저장되며, 기본 위치는 서버 자체의 설치 디렉터리입니다. npx -y @modelcontextprotocol/server-memory로 실행하며, 버전 2.0.0(2026년 10월 19일)부터는 Node.js 24 이상이 필요합니다. 이름 있는 볼륨과 함께 mcp/memory Docker 이미지로 실행할 수도 있습니다. 계정이나 키는 필요 없습니다.
Memory (reference server) 설치 방법
npx -y @modelcontextprotocol/server-memoryMemory (reference server), 쓸 만한 가치가 있습니까?
Memory는 개인용 에이전트 메모리를 위한, 탄탄하고 들여다볼 수 있는 출발점입니다. 하지만 그래프가 모델이 훑어볼 수 있는 크기를 넘어서면 잘 맞지 않습니다. 강점은 숨겨진 것이 없다는 점입니다. 메모리는 열어 보고, 비교하고, 백업하고, 지울 수 있는 텍스트 파일이며, 아무것도 기기 밖으로 나가지 않습니다.
약한 부분은 검색입니다. 소스 코드를 보면 search_nodes는 이름, 유형, 관찰 텍스트를 대상으로 대소문자를 구분하지 않는 부분 문자열 일치를 수행하며, 쿼리는 2,048자로 제한되고 임베딩이나 순위 매기기는 없습니다. 관찰 내용이 'reports to Priya'인데 'my manager'를 찾으면 아무것도 돌아오지 않습니다. read_graph는 모든 것을 돌려주는 방식으로 이를 피하는데, 엔터티가 수십 개일 때는 괜찮지만 파일이 커지면 컨텍스트 비용이 됩니다. 전용 메모리 서비스와, 여러 채팅 앱과 코딩 에이전트에 내장된 메모리는 이 서버가 하지 않는 의미 기반 회상을 시도합니다.
최근 릴리스는 공유를 위험하게 만들던 데이터 손실 문제를 고쳤습니다. 버전 1.0.0부터 모든 쓰기 도구가 잠금 파일을 잡으므로, 파일 하나를 가리키는 두 클라이언트가 더 이상 서로의 변경을 버리지 않습니다. 서버가 해석하지 못하는 줄은 다음 저장 때 지워지지 않고 남으며, 파일은 0600 권한을 유지합니다. 잠금은 배타적 파일 생성에 의존하므로, README는 네트워크 파일 시스템에서는 여전히 안전하게 공유할 수 없다고 경고합니다.
무엇을 기억할지는 모델이 정하며, 이것이 설계이자 위험입니다. 언제 저장하고 찾아볼지 알려 주는 시스템 프롬프트가 없으면 회상은 들쭉날쭉하고, 에이전트가 이메일이나 웹 페이지에서 읽은 텍스트가 관찰 내용으로 기록되어 이후의 모든 세션에서 다시 재생될 수 있습니다. Issue #4117은 할당량, 민감 정보 가리기, 파괴적 작업에 대한 안전 장치를 요청하지만, 아직 아무것도 반영되지 않았습니다.
제 역할을 하는 곳
노트북 한 대에서 Claude Desktop과 Claude Code를 쓰는 1인 개발자
두 클라이언트가 세션 사이에 프로젝트 규칙과 사람들을 기억하게 하기
두 클라이언트가 같은 MEMORY_FILE_PATH를 가리키게 합니다. 잠금 파일이 쓰기를 순서대로 처리하므로 어느 쪽도 상대의 변경을 잃지 않습니다. 무료이고 로컬에서 실행되지만, 회상은 채팅을 시작할 때마다 메모리를 검색하라고 모델에게 알려 주는 시스템 프롬프트에 달려 있습니다.
에이전트 메모리 계층의 프로토타입을 만드는 플랫폼 엔지니어
벡터 저장소를 도입하기 전에 엔터티와 관계 기반 메모리 모델 시험하기
JSONL 형식은 살펴보고 옮기기 쉬우므로, 실험에 드는 비용은 시간뿐입니다. 쿼리가 정확한 단어가 아니라 의미로 일치해야 하거나, 여러 사용자가 메모리 하나를 공유하게 되면 교체할 것을 예상하십시오.
50인 엔지니어링 팀의 MCP 서버를 승인하는 보안 검토자
직원이 업무용 노트북에서 메모리 서버를 실행해도 되는지 정하기
모든 것이 노트북의 파일에 머물므로 평가할 제3자 처리자가 없습니다. 따져 볼 위험은 세션을 넘어 남는 주입된 텍스트와 기본 파일 위치입니다. 암호화되고 백업되는 경로로 MEMORY_FILE_PATH를 지정하도록 요구하면 두 번째 위험은 해결됩니다.
도입 전 확인할 점
- 설정
- 클라이언트 설정에 npx -y @modelcontextprotocol/server-memory를 추가하고(README에 Claude Desktop과 VS Code용 스니펫이 있습니다) MEMORY_FILE_PATH를 설정합니다. 2.0.0부터는 Node.js 24+가 필요합니다. 재시작하면 도구가 작동하지만, 쓸모 있는 회상에는 언제 읽고 쓸지 모델에게 알려 주는 시스템 프롬프트가 필요합니다.
- 연동
- 9개의 도구가 있습니다. create_entities, create_relations, add_observations, delete_entities, delete_observations, delete_relations, read_graph, search_nodes, open_nodes입니다. 9개 중 6개가 쓰기를 하며, 그래프는 구독할 수 있는 MCP 리소스이기도 합니다.
- 데이터와 개인정보
- 자신의 JSONL 파일만 읽고 쓰며, 네트워크나 자격 증명은 쓰지 않습니다. 에이전트가 읽은 것은 무엇이든 관찰 내용으로 저장되어 이후 채팅에 다시 들어갈 수 있으므로, 프롬프트 인젝션이 그것을 실어 온 세션보다 오래 살아남을 수 있습니다.
- 대규모 사용 시 비용
- 무료이며 요청 한도가 없습니다. 비용은 컨텍스트입니다. read_graph는 그래프 전체를 돌려주므로, 저장된 엔터티와 관찰 내용이 늘어날 때마다 토큰 비용도 늘어납니다.
- 제한
- 부분 문자열 검색이며 쿼리는 2,048자로 제한됩니다. 임베딩, 순위 매기기, 다중 사용자 접근, 할당량이 없습니다. 네트워크 파일 시스템에서는 안전하지 않으며, 2.0.0에서는 10 MiB가 넘는 JSON-RPC 메시지 하나가 stdio 연결을 끊습니다.
좋은 점
- 메모리가 읽고 편집할 수 있는 로컬 JSONL 파일 하나입니다
- 1.0.0부터 쓰기 잠금으로 클라이언트 사이의 변경 손실을 막습니다
- 계정, 키, 네트워크 접근이 필요 없습 니다
아쉬운 점
- 부분 문자열 검색뿐이며 의미 기반 회상이 없습니다
- 모델이 저장하고 검색하도록 프롬프트로 지시해야 합니다
- 할당량이나 민감 정보 가리기가 없어 주입된 텍스트가 남을 수 있습니다
추천 대상
MCP를 통한 지속적 메모리가 어떻게 작동하는지 배우는 취미 사용자와 개발자입니다.
Memory (reference server) 대안
Memory (reference server): 자주 묻는 질문
- Memory (reference server), 쓸 만한 가치가 있습니까?
- 읽기 쉬운 로컬 파일과 부분 문자열 검색 덕분에 에이전트 하나를 위한 노트로는 괜찮지만, 그래프가 커지면 장기 메모리로는 약합니다. 평점은 5점 만점에 3.5점입니다.
- Memory (reference server)의 가격은 얼마입니까?
- 무료 오픈소스입니다.
- Memory (reference server)의 단점은 무엇입니까?
- 부분 문자열 검색뿐이며 의미 기반 회상이 없습니다; 모델이 저장하고 검색하도록 프롬프트로 지시해야 합니다; 할당량이나 민감 정보 가리기가 없어 주입된 텍스트가 남을 수 있습니다.
- Memory (reference server)에 적합한 사람은 누구입니까?
- MCP를 통한 지속적 메모리가 어떻게 작동하는지 배우는 취미 사용자와 개발자입니다.
- 팀이나 프로덕션 환경에서 Memory (reference server)의 비용은 얼마입니까?
- 무료이며 요청 한도가 없습니다. 비용은 컨텍스트입니다. read_graph는 그래프 전체를 돌려주므로, 저장된 엔터티와 관찰 내용이 늘어날 때마다 토큰 비용도 늘어납니다.
- Memory (reference server)에 회사 데이터를 맡겨도 안전합니까?
- 자신의 JSONL 파일만 읽고 쓰며, 네트워크나 자격 증명은 쓰지 않습니다. 에이전트가 읽은 것은 무엇이든 관찰 내용으로 저장되어 이후 채팅에 다시 들어갈 수 있으므로, 프롬프트 인젝션이 그것을 실어 온 세션보다 오래 살아남을 수 있습니다.
- Memory (reference server)의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Sequential Thinking (reference server), Filesystem (reference server) 및 MCP Memory Keeper입니다.
답변 확인일: 2026년 10월 23일.
