그때 뭐랬지? 🧠💬

내 대화를 기억해주는 개인 기억(Personal Memory) MCP 서버 — Kakao PlayMCP AGENTIC PLAYER 10 출품작

"철수랑 마지막에 무슨 얘기했더라?", "지난달에 약속한 게 뭐였지?" 사람은 대화를 잊지만, 「그때 뭐랬지?」는 잊지 않습니다.

대부분의 MCP 서버가 외부 API를 연동하는 데 그치는 것과 달리, 이 서버는 사용자 동의 하에 사용자의 대화 내용 자체를 DB화하고 MCP 도구로 다시 꺼내 쓰게 하는 개인 기억 저장소라는 새로운 발상에서 출발했습니다.

어떻게 쓰나요?

AI 채팅(PlayMCP AI 채팅, Kakao Tools 등)에서 자연어로 대화하면 에이전트가 도구를 호출합니다.

👤 "기억상자 하나 만들어줘"
🤖 → create_memory_box → "box_key를 안전한 곳에 보관하세요!"

👤 "철수랑 다음주 화요일에 점심 먹기로 한 거 기억해줘"
🤖 → remember(person: 철수, kind: promise, happened_at: ...)

... 2주 뒤 ...

👤 "나 철수랑 뭐 하기로 했었지?"
🤖 → recall(query: "철수") → "다음주 화요일 점심 약속이 있었어요"

👤 "영희에 대해 내가 기억해둔 거 다 보여줘"
🤖 → person_summary(person: 영희) → 취향/약속/메모 정리

MCP 도구 목록

도구	설명
create_memory_box	기억상자 생성, 접근 키(box_key) 발급
remember	대화 내용 저장 (사람, 종류, 태그, 날짜 포함)
recall	키워드/사람/종류로 기억 검색
person_summary	특정 사람에 대한 기억을 종류별로 요약
list_people	기억에 등장하는 사람 목록
list_promises	약속만 날짜순으로 조회
memory_stats	기억상자 현황
forget	개별 기억 삭제
delete_memory_box	상자 전체 영구 삭제
export_memories	전체 기억 JSON 내보내기

기억 종류(kind): note(메모) · promise(약속) · preference(취향)

설계 포인트

• Streamable HTTP (stateless): 요청마다 MCP 서버 인스턴스를 생성하는 무상태 구조로, 세션 관리 없이 수평 확장이 가능합니다. PlayMCP가 요구하는 원격 HTTPS Endpoint에 그대로 연결됩니다.
• 한국어 검색: SQLite FTS5 트라이그램은 한국어 2글자 토큰("점심", "약속")을 매칭하지 못하는 제약이 있어, 개인 기억 규모(상자당 최대 5,000건)에 맞는 다중 토큰 AND 매칭 + 출현 빈도 스코어링을 자체 구현했습니다.
• 프라이버시 우선: 자동 수집 없음, UUID 키 기반 상자 격리, 삭제·내보내기 도구 제공. 자세한 내용은 PRIVACY.md 참고.

개발

npm install
npm run dev        # 개발 서버 (기본 :3000)
npm test           # 테스트 (vitest)
npm run build      # dist/ 빌드
npm start          # 프로덕션 실행

환경변수:

변수	기본값	설명
PORT	3000	리스닝 포트
DB_PATH	data/memories.db	SQLite 파일 경로 (:memory: 가능)

엔드포인트:

• POST /mcp — MCP Streamable HTTP 엔드포인트
• GET /healthz — 헬스체크

로컬 확인:

curl -X POST http://localhost:3000/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'

배포 (카카오클라우드 → PlayMCP)

1. 컨테이너 빌드/실행:

   docker build -t remember-talk-mcp .
   docker run -p 3000:3000 -v $(pwd)/data:/data remember-talk-mcp
   

2. 카카오클라우드 등에 배포해 HTTPS Endpoint 확보 (https://<도메인>/mcp)
   • DB_PATH가 가리키는 볼륨을 영속 스토리지로 마운트할 것
3. PlayMCP 개발자 콘솔에서 MCP 서버 등록 → Endpoint 입력
4. AI 채팅에서 도구 동작 테스트
5. 서버 공개 상태를 전체 공개로 전환
6. 페이지 하단 Player 예선 참여 버튼으로 접수 (마감: 7/14)

로드맵 (본선 고도화 후보)

• [ ] 카카오 OAuth 연동 — 키 없이 계정 기반 접근
• [ ] 약속 리마인더 — 다가오는 약속 알림
• [ ] 임베딩 기반 의미 검색 — "돈 얘기" → 축의금/월급 기억까지 검색
• [ ] box_key 파생 키를 이용한 at-rest 암호화
• [ ] 기억 자동 요약 — 사람별 관계 타임라인 생성

라이선스

MIT