메모리 MCP란 무엇인가?

Memory MCP는 에이전트가 세션 전반에 걸쳐 학습한 내용을 기록하는 서버입니다. Magnemo는 이러한 메모리를 사용자가 소유하는 일반 파일 형태로 유지하는 시스템 중 하나입니다.

'메모리'라고 불리는 두 가지 것

이 단어는 두 가지 다른 역할을 포괄합니다. 첫 번째는 저장소(repo)의 코드 인덱스입니다. 에이전트가 무언가를 찾을 수 있도록 파일, 심볼 및 기록에 대한 검색 기능을 제공합니다. 다른 하나는 에이전트가 학습하고 결정한 내용입니다. 즉, 왜 특정 스키마를 선택했는지, 어떤 수정 사항이 실패했는지, 다음 세션에서 무엇부터 해야 하는지 등입니다. 인덱스는 코드로부터 재구축될 수 있습니다. 하지만 컨텍스트 윈도우(context window)가 닫히고 압축(compaction)이 중요했던 것을 추측할 때, 결정된 내용은 복구할 수 없습니다. Magnemo는 후자(두 번째 종류)에 해당합니다.

네 가지 도구

• retrieve: 사람이 승인한 메모(note)인 캐논(canon)을 읽어옵니다.
• stage: 메모를 제안합니다. 에이전트는 제안만 할 수 있습니다.
• bootpack: 다음 세션이 가장 먼저 읽어야 할 내용을 반환합니다.
• handoff: 다음 세션을 위해 메모와 함께 세션을 종료합니다.

붙여넣기 및 설정

설치한 후, 마크다운 파일 폴더인 볼트(vault)를 만드세요:

pip install magnemo
magnemo init ./vault

또는 uvx magnemo-mcp로 실행합니다. 그리고 절대 경로와 함께 이 내용을 MCP 클라이언트의 설정에 추가하세요:

{
  "mcpServers": {
    "magnemo": {
...

Claude Code가 테스트된 클라이언트이며, Claude Desktop, Cursor 및 기타 MCP 클라이언트는 동일한 블록을 사용하지만 여기서는 테스트되지 않았습니다. 스테이징된 메모는 magnemo yes를 실행할 때 보존됩니다. 승격(Promotion)은 MCP 도구가 아닙니다. 모든 항목에는 누가 작성했고, 누가 승인했으며, 언제 기록했는지가 기록됩니다. 더 새로운 메모가 이전 메모를 대체하며, 이전 메모는 내용이 온전히 유지된 채 아카이브됩니다. 비밀 정보나 주입된 명령어처럼 보이는 메모는 문지기 단계에서 오염(tainted) 처리되어 서버를 통해 제공되지 않습니다.

관련 질문

내 에이전트가 왜 잊어버리나요? 창이 채워지고, 압축이 요약하며, 살아남는 것은 확인되지 않은 것입니다.

Claude Code 메모리는 이것과 어떻게 작동하나요? Claude Code는 MCP 서버에 연결하여 승인된 기록으로부터 각 세션을 부팅합니다.

500일차에 무슨 일이 일어나나요? 매우 긴 저장소(vault)에서의 신선도(staleness)는 아직 풀리지 않은 질문이며, 해당 페이지에서도 그렇게 언급하고 있습니다.

처음 게시된 곳: magnemo.ai/memory-mcp. Magnemo는 오픈 소스입니다: github.com/Magnemo-AI/magnemo.