Memento v1.0: Claude Code용 지속적 메모리 MCP 서버, 17개의 도구 포함

Memento v1.0는 AI 코딩 에이전트에게 세션 간 장기 기억을 제공하는 Claude Code용 지속적 메모리 MCP 서버입니다. 이 도구는 클라우드 의존성, API 키, 원격 측정 없이 완전히 로컬에서 실행됩니다.

핵심 기능

서버는 17개의 MCP 도구를 제공합니다: 저장, 불러오기, 검색, 삭제, 목록, 내보내기, 가져오기, 수집, 색인, 마이그레이션, 압축, 통계, 프로필, 관련 항목, 세션 시작, 세션 요약, 상태 확인.

검색 기능

• 벡터 검색: HNSW 인덱스를 사용한 코사인 유사도로 의미 기반 메모리 찾기
• 키워드 검색: 정확한 용어 매칭을 위한 완전한 BM25 구현 (Elasticsearch와 동일한 알고리즘)
• 하이브리드 검색: 70% 벡터 + 30% BM25 점수화를 결합하며, 제작자가 매일 사용하는 방식

지능형 메모리 관리

• 모순 감지: 결정을 변경할 때 자동으로 대체 관계 생성 (예: "PostgreSQL 사용" → "PostgreSQL에서 CockroachDB로 전환") 및 오래된 정보 우선순위 낮춤
• 중요도 점수화: 명시적 저장 > 자동 캡처, 결정 > 대화, 347일 지수 감쇠로 최근 컨텍스트가 먼저 표시됨
• 지식 그래프: 모든 메모리에서 파일 경로, 함수, 클래스, 패키지, URL, 환경 변수 추출

시각화 및 API

memento serve는 localhost:7007에서 로컬 서버를 시작하여 다음을 제공합니다:

• 태그별로 색상이 지정된 노드와 관계를 보여주는 간선이 있는 D3.js 힘 기반 방향 그래프 시각화
• 17개 도구를 모두 반영하는 REST API

프로덕션 기능

• 내결함성을 위한 회로 차단기
• 충돌 복구를 위한 선행 기록 로그
• 임베딩을 위한 LRU 캐시

IDE 및 브라우저 통합

• 다중 IDE 지원: Claude Code, Cursor, Windsurf, OpenCode, 네 가지 모두에서 공유 메모리 저장소 사용
• Chrome 확장 프로그램: 모든 페이지나 선택 항목을 우클릭하여 메모리에 직접 저장

사용 데이터

v1.0 개발 중, Memento는 27개 세션에서 2,191개의 메모리를 캡처했습니다: 자동 캡처 훅에서 1,905개, 세션 요약에서 206개, 명시적 저장에서 79개. 이는 53MB의 검색 가능한 엔지니어링 컨텍스트를 생성했습니다.

설정 및 리소스

설정 명령: npx memento-memory setup

• GitHub: https://github.com/sanathshetty444/memento
• Documentation: https://sanathshetty444.github.io/memento/
• Full writeup: https://medium.com/@sanathshetty444/it-remembered-9e7d10f444ff