MCP-Memory
공개 지식 형식으로 기억을 남기는 MCP 서버
python3 setup.py에이전트에 세션을 넘어 남는 장기 기억을 붙입니다. 기억 항목은 공개 지식 형식 규격에 맞춘 마크다운 문서로 저장되고 앞머리에 종류와 키, 이름 공간, 태그, 생성 시각, 출처, 검증 여부, 상태, 만료 시점이 붙습니다. 저장 구조가 두 겹입니다. 사람이 그대로 열어 볼 수 있는 마크다운 묶음이 디스크에 쌓이고 계층형 색인과 갱신 기록이 함께 유지됩니다. 동시에 SQLite 전문 검색 색인이 붙어 키 조회와 키워드 검색이 빠릅니다. 이름 공간으로 사용자 취향과 프로젝트 구조 같은 맥락을 분리합니다. 설치 마법사가 깔려 있는 MCP 도구를 찾아 알아서 설정합니다.
판단
이럴 때 씁니다
- 기억을 사람이 그대로 열어 볼 수 있게 남기고 싶을 때
- 이름 공간으로 맥락을 나눠야 할 때
- 빠른 키 조회와 검색이 함께 필요할 때
이럴 땐 쓰지 마세요
- 기억을 자동으로 요약해 주지는 않습니다
- 저장 규격이 정해져 있어 자유 형식은 아닙니다
- 판이 1.0 이라 실제 사용 사례가 아직 적습니다
차별점
- 공개 지식 형식 규격을 그대로 따릅니다.
- 사람이 읽는 마크다운과 빠른 색인을 두 겹으로 유지합니다.
- 이름 공간으로 맥락을 분리합니다.
- 설치 마법사가 여러 도구를 한 번에 설정합니다.
워크플로
- 01설치 마법사를 돌립니다.
- 02깔려 있는 도구가 자동으로 설정되게 둡니다.
- 03이름 공간을 나눠 기억을 저장합니다.
- 04키나 태그, 내용으로 찾습니다.
- 05디스크에 쌓인 마크다운을 직접 열어 봅니다.
주요 명령
| 명령 | 설명 |
|---|---|
python3 setup.py | 설치 마법사가 깔려 있는 MCP 도구를 찾아 설정합니다. |
memory_store | 기억을 저장하거나 갱신합니다. |
함정
설치 전에 확인하세요
- 저장할 때 프로젝트 경로를 반드시 넘겨야 합니다. 이 값이 저장 위치를 정합니다.
- 기억 항목이 정해진 규격의 마크다운입니다. 자유 형식으로 넣을 수 없습니다.
- 디스크 묶음과 색인이 함께 유지됩니다. 파일을 손으로 고치면 색인과 어긋날 수 있습니다.
- 만료 시점 필드가 있지만 오래된 기억을 알아서 지워 주지는 않습니다.
비교
기억 도구는 저장 형식이 각자 달라 다른 도구로 옮기기 어렵습니다. 이쪽은 공개 규격을 따르고 결과가 평범한 마크다운이라 옮겨 쓰기 쉽습니다. 대신 무엇을 기억할지는 여전히 사람이나 에이전트가 정해야 합니다.
최근 변경
1.0 이 첫 정식 판입니다. 저장소가 별도 변경 요약 대신 기능 설명을 릴리스 본문에 담아 두었습니다.