MCP 메모리 게이트웨이: Claude Code에서 지속적 메모리를 위한 MCP 서버

MCP Memory Gateway는 Claude Code를 위해 특별히 구축된 MCP 서버로, 세션 간에 지속적인 메모리를 제공합니다. 이 프로젝트는 Claude Code가 세션 사이에 모든 컨텍스트를 잃어버려 사용자가 "PR 리뷰 스레드를 확인하지 않고 푸시하지 마세요"와 같은 지시를 여러 번 반복해야 하는 문제를 해결합니다.

작동 방식

시스템은 네 가지 주요 구성 요소를 통해 작동합니다:

• 캡처: 사용자는 Claude Code가 잘못된 일을 했을 때(무엇이 잘못되었는지, 무엇을 변경해야 하는지) 또는 올바른 일을 했을 때 구조화된 피드백을 기록합니다.
• 승격: 동일한 실패가 3회 이상 발생하면 자동으로 예방 규칙이 됩니다.
• 게이트: 예방 규칙은 PreToolUse 훅이 됩니다. Claude Code가 도구 호출을 실행하기 전에 게이트 엔진이 알려진 실패 패턴과 일치하는지 확인합니다. 일치하면 호출이 차단되고 이유와 대안이 설명됩니다.
• 리콜: 세션 시작 시, 이전 세션의 관련 컨텍스트가 주입되어 Claude Code가 그렇지 않으면 잃어버릴 역사를 갖게 됩니다.

Claude Code로 개발하기

개발자는 몇 달 동안 주요 개발 도구로 Claude Code를 사용했습니다. Claude Code는 프로젝트의 거의 모든 부분에 관여했습니다:

• 저장된 실패 규칙과 도구 호출을 비교하는 패턴 매칭 시스템을 포함한 초기 게이트 엔진 로직 작성
• 구조화된 항목이 저장되기 전에 올바른 스키마를 갖는지 확인하는 피드백 검증 시스템 생성
• 도구 등록, 요청 라우팅, 응답 형식 처리를 담당하는 MCP 프로토콜 통합 레이어 구축
• 중첩된 도구 호출에서 예방 규칙이 작동하지 않던 버그를 진단하고 재귀적 도구 체인을 처리하도록 매칭 로직을 재작성하여 수정
• 리팩토링, 테스트 작성, 세션 시작 시 주입할 컨텍스트를 선택하는 리콜 시스템 반복 작업에 매일 사용

시작하기

핵심은 완전히 오픈 소스이며 제한 없이 MIT 라이선스로 제공됩니다. 설정은 한 명령어로 완료할 수 있습니다:

npx mcp-memory-gateway init --agent claude-code

프로젝트는 GitHub에서 확인할 수 있습니다: https://github.com/IgorGanapolsky/mcp-memory-gateway.