MemPalace: 클로드가 더 이상 잊어버리지 않게 해주는 도구

BBetter Stack
컴퓨터/소프트웨어창업/스타트업AI/미래기술

Transcript

00:00:00Claude가 세 번이나 같은 실수를 했습니다. 모델이 멍청해서가 아니라,
00:00:04여러분의 프로젝트에 대한 기억이 없기 때문입니다. 지난주에 내린 결정도 기억하지 못하고,
00:00:09왜 GraphQL로 전환했는지, 그리고 여러분이 나눴던 이상한 대화들도 기억하지 못하죠.
00:00:14이것은 MemPallas입니다. GitHub에서 52,000개 이상의 별을 받으며 화제가 되었죠.
00:00:20우리의 AI 도구에 로컬에서 손실 없는 장기 기억을 제공한다고 합니다. MemPallas가 무엇인지,
00:00:26어떻게 작동하는지, 그리고 우리가 가진 다른 도구들과의 핵심 차이점을 보여드리겠습니다.
00:00:35간단히 말해 MemPallas는 우리의 대화를 한 글자도 빠짐없이 로컬에 저장하며,
00:00:43Claude 코드 훅과 MCP 도구를 지원하고, 핵심 메모리 흐름에 API 키가 필요 없습니다.
00:00:49여기서 짚고 넘어가야 할 점은 분명히 누군가 이렇게 말할 거라는 겁니다.
00:00:52이미 컨텍스트 모드가 있지 않냐고요. 네, 맞습니다. 컨텍스트 모드는 긴 코딩 세션을 유지할 때,
00:00:59컨텍스트 창이 터지는 것을 막는 데 유용하죠. MemPallas는 다릅니다. AI에게 대화와
00:01:06심지어는 며칠이 지나도 완전히 넘나드는 영구적인 메모리 접근 권한을 줍니다. 둘은 실제로 함께 사용하면 좋아서,
00:01:12나란히 실행할 수도 있습니다. MemPallas는 아주 직관적입니다.
00:01:17설정 방법과 실제 환경에서 어떻게 작동하는지 보여드리죠. 여러분의 작업 흐름을 빠르게 해주는
00:01:22코딩 도구를 좋아하신다면 꼭 구독해 주세요. 계속해서 영상이 올라오고 있습니다.
00:01:27많은 메모리 도구가 실패하는 지점인 데모부터 바로 시작해보겠습니다.
00:01:30UV tool install MemPallas를 실행할 겁니다. 저장소에서는 현재 의존성 충돌을 피하기 위해 UV를
00:01:37권장하지만, 여러분의 설정에 따라 PIP를 사용해도 됩니다. 그런 다음 프로젝트 내에서
00:01:43MemPallas init을 실행하여 프로젝트를 위한 궁전을 초기화합니다. AI가 잊지 말아야 할
00:01:51것들을 위한 로컬 메모리 데이터베이스를 만드는 거죠. 이제 프로젝트 파일, 노트, 그리고 과거의
00:01:58Claude 코드 세션을 마이닝합니다. MemPallas mine 명령어로 가능하죠. 그다음 저는 이전의
00:02:06Claude 대화 내용들도 MemPallas mine으로 추가할 겁니다. 이게 핵심입니다. 실제 프로젝트 컨텍스트는
00:02:11한곳에 모여 있지 않거든요. 커밋, 문서, 대화, 노트, 랜덤한 마크다운 파일에 흩어져 있고, 반은
00:02:18만들었는지조차 기억나지 않을 겁니다. 이제 MemPallas에게 질문을 검색해볼 수 있습니다. “왜 GraphQL로 전환했지?”
00:02:25그럼 오늘의 프롬프트에서 추측하는 대신, 그 결정이 내려졌던 과거의 논의 내용을 가져옵니다. 이것이
00:02:32첫 번째로 큰 차이점입니다. AI에게 더 큰 프롬프트는 필요 없습니다. 더 나은 기억력이 필요할 뿐이죠.
00:02:37MemPallas mine을 실행하면 모든 것을 학습시키는 단계로 넘어갑니다. 지정한 폴더에 들어가서,
00:02:44발견한 모든 파일을 읽고 더 작은 조각으로 나눕니다. 그다음 그 내용을 오프로드해서
00:02:50메모리 궁전에 원문 그대로 저장하여 우리가 검색할 수 있게 만드는 것이죠. MemPallas는
00:02:55정확히 무엇을 할까요? 데모는 잘 작동했고 어떻게 작동하는지도 보았습니다. 메모리 궁전 은유를 사용하여,
00:03:00프로젝트나 사람들을 실제 인프라로 만들고, 사실과 사건들과 관련된 것들은
00:03:06각기 다른 방에 살게 합니다. 원본 소스 텍스트는 서랍 속에 들어있죠. 하지만
00:03:12그런 은유에 주의를 뺏기지 마세요. 중요한 것은 원본 콘텐츠가 그대로 보존된다는 것입니다. 대부분의 메모리 시스템은
00:03:18가장 먼저 뻔한 짓을 합니다. 복잡한 대화를 가져와서 LLM에게 깔끔한 사실로 요약하라고 하죠. 똑똑해 보이지만,
00:03:25치명적인 문제가 있습니다. 요약 과정에서 이상한 제약 사항, 엣지 케이스, 혹은 결정의 이유가
00:03:31누락되면 그 정보는 메모리에서 사라집니다. MemPallas는 정반대의 방식을 택합니다. 원문을
00:03:38한 글자도 안 빠뜨리고 그대로 보존한 뒤 그 위에 컴팩트한 인덱스를 쌓습니다. 그래서 AI는
00:03:44안에 있는 내용을 버리지 않고도 알맞은 곳을 찾아낼 수 있습니다. 기술적으로는 개발자 친화적이죠. 검색용으로 디스크에 ChromaDB,
00:03:51지식 그래프용으로 SQLite를 씁니다. 에이전트가 메모리를 직접 사용할 수 있게 하는 MCP 통합과,
00:03:57옆으로 빠지는 게 아니라 실제 코딩 작업 흐름에 맞출 수 있는 Claude 코드 훅을 갖췄죠. MemZero나 Zapp은
00:04:03더 상품화되어 있고, SDK 중심적이며, 애플리케이션이나 제품에 메모리를 내장할 때 더 적합할 수 있습니다.
00:04:09MemPallas는 코딩 에이전트가 실제 작업 기록을 로컬에 기억하게 하고 싶은 개발자를 위한 도구처럼 느껴집니다.
00:04:16절충점은 명확합니다. 호스팅된 서비스를 원한다면 다른 도구들이 더 좋을 겁니다.
00:04:21원본 소스를 그대로 유지하는 로컬 메모리 시스템을 원한다면 MemPallas가 확실히 우위에 있습니다.
00:04:27Claude 코드 통합 부분이 더 실용적으로 느껴지는 지점입니다. 플러그인이
00:04:33MCP 서버를 시작하고, 도구를 노출하고, Claude에게 메모리 프로토콜을 가르치고, 과거 작업에 대해
00:04:39답하기 전에 메모리 궁전을 먼저 검색하게 합니다. 사소해 보이지만 그렇지 않습니다. 어딘가에 데이터베이스가 있다는 것과,
00:04:45내 코딩 에이전트가 답하기 전에 무엇을 기억해야 할지 알고 있다는 것 사이에는 엄청난 차이가 있죠.
00:04:50개발자들이 선호하는 점은 이렇습니다. 첫째, 정확한 기억. 3주 전에 뭔가 이상하지만 중요한 말을 했다면,
00:04:57깔끔하게 요약된 내용 대신 원래의 문구 그대로를 가져올 수 있습니다. 그리고 비용과
00:05:03개인정보 보호죠. 공식 문서에 따르면 디스크에 있는 ChromaDB와 SQLite를 사용하므로,
00:05:11핵심 흐름에 API 키가 필요 없습니다. 그다음은 낮은 시작 컨텍스트입니다. 매번 4만 토큰의
00:05:18프로젝트 배경 지식을 붙여넣을 필요가 없습니다. 이것을 실행하면 에이전트가 어디를
00:05:24봐야 할지 알 수 있는 충분한 포인터를 로드합니다. 시간적 지식 그래프도 중요한 부분입니다. 소프트웨어 결정은 시간이 지나면 만료되니까요.
00:05:31우리는 REST API를 사용합니다. 그건 두어 달 전에는 사실이었을지 몰라도, 지난달에는 틀린 말이었을 수도 있죠.
00:05:38일반적인 사실 데이터베이스는 그걸 놓칠 수 있습니다. 시간에 민감한 메모리 시스템은 무엇이 언제 바뀌었는지,
00:05:44이해할 가능성이 훨씬 높습니다. 이것이 두 번째 큰 차이입니다. 메모리는 단순히 사실에 대한 것이 아니라,
00:05:50시간에 대한 것이기도 합니다. 궁전 계층 구조는 영리하지만 완벽하지는 않습니다. 일부 프로젝트에서는,
00:05:57대화 내용에 대해 ChromaDB로 시맨틱 검색만 수행해도 더 적은 개념으로 대부분의 가치를 얻을 수 있습니다.
00:06:02설정과 유지 관리 문제도 있습니다. 로컬 데이터베이스는 백업, 정리, 마이그레이션,
00:06:08또는 동기화가 필요해지기 전까지는 아주 좋습니다. 그리고 이것은 메모리 플랫폼을 관리하는 종합 관리 도구가 아닙니다.
00:06:15관리자 제어, 대시보드, 권한 설정 등을 원하신다면 아직은 부족합니다. 실제적인 경고를 하나 드리자면,
00:06:21이 프로젝트가 바이럴이 되면서 사칭 도메인들이 생겨났습니다. 리드미에는 공식 소스가
00:06:28GitHub 저장소와 파이썬 패키지, 문서 사이트라고 적혀 있습니다. 그러니 검색해서 나오는 이상한 Mem Palace
00:06:34웹사이트에서 설치하지 마세요. 작은 경고가 아닙니다. 이건 여러분의 프로젝트 기록을
00:06:39건드리는 도구이므로, 개발 환경의 일부처럼 다뤄야 합니다. 만약 Claude 코드,
00:06:44Cursor, 혹은 로컬 에이전트를 사용 중이라면 이건 합리적인 선택입니다. 아니면 로컬 우선 도구를 선호하고,
00:06:48그저 AI가 이미 했던 말을 기억하게 하려고 구독료를 내는 게 싫으신 분들께 좋습니다.
00:06:53설정이 필요 없는 호스팅 서비스를 원하시거나,
00:06:57프로젝트가 충분히 짧아서 리드미와 좋은 프롬프트만으로 문제가 해결된다면 굳이 이 도구를 쓰지 마세요.
00:07:02이런 코딩 도구가 즐거우셨다면, BetterStack 채널을 구독해 주세요. 다음 영상에서 뵙겠습니다.

Key Takeaway

MemPalace는 프로젝트의 모든 대화, 커밋, 노트를 로컬에 원본 그대로 저장하고 시간적 맥락을 고려한 인덱스를 구축함으로써 AI 코딩 에이전트에게 영구적이고 정확한 기억력을 제공하는 도구입니다.

Highlights

  • MemPalace는 AI 모델이 프로젝트 히스토리와 결정 사항을 잊지 않도록 로컬 데이터베이스에 원문을 손실 없이 저장합니다.

  • GitHub에서 52,000개 이상의 별을 받은 프로젝트로, Claude 코드 훅 및 MCP 도구와 통합되어 AI의 컨텍스트 창 한계를 극복합니다.

  • 일반적인 요약 방식과 달리 원본 텍스트를 그대로 보존하며 그 위에 컴팩트한 인덱스를 쌓아 정확한 검색을 지원합니다.

  • 검색을 위해 ChromaDB(디스크 저장)와 SQLite(지식 그래프)를 활용하며, 핵심 메모리 흐름에서 API 키를 요구하지 않습니다.

  • 시간적 지식 그래프를 도입하여 소프트웨어 결정 사항이 시간이 지남에 따라 만료되거나 변경되는 점을 추적합니다.

Timeline

MemPalace의 개념과 필요성

  • AI 모델이 프로젝트의 지난 결정이나 대화 내용을 기억하지 못하는 문제를 해결합니다.
  • 기존의 컨텍스트 모드와는 달리, 며칠이 지나도 유지되는 영구적인 메모리 접근 권한을 제공합니다.
  • API 키 없이 핵심 메모리 흐름을 처리하며, GitHub에서 화제가 된 오픈소스 프로젝트입니다.

AI는 종종 긴 코딩 세션에서 이전 맥락을 놓치며 실수를 범합니다. MemPalace는 이러한 문제를 해결하기 위해 로컬 환경에 모든 대화 내용을 한 글자도 빠짐없이 저장합니다. 컨텍스트 모드가 긴 세션 중 창이 터지는 것을 막는 보조 도구라면, MemPalace는 영구적인 저장소 역할을 수행합니다.

설치와 로컬 메모리 구축 과정

  • UV나 PIP를 통해 설치 후 프로젝트를 초기화하여 메모리 데이터베이스를 생성합니다.
  • mine 명령어를 통해 프로젝트 파일, 노트, 이전 Claude 대화 기록을 데이터베이스로 마이닝합니다.
  • 데이터는 각 사실과 사건의 맥락에 따라 별도의 방으로 분류된 메모리 궁전 구조로 관리됩니다.

프로젝트 컨텍스트는 문서, 커밋, 대화 등으로 흩어져 있습니다. 사용자는 MemPalace init으로 초기화한 뒤, MemPalace mine 명령어를 사용하여 흩어진 데이터들을 수집합니다. 이를 통해 AI는 특정 결정(예: GraphQL 전환 이유)에 대해 추측하는 대신 과거 논의 내용을 직접 검색합니다.

기술적 아키텍처와 차별점

  • 많은 메모리 시스템이 수행하는 텍스트 요약 방식 대신 원본 데이터를 그대로 보존합니다.
  • 검색을 위해 ChromaDB와 SQLite를 사용하며, 실제 개발 작업 흐름에 맞춘 Claude 코드 훅을 지원합니다.
  • 시간적 지식 그래프를 통해 과거에는 맞았으나 현재는 틀린 결정 사항들을 관리합니다.

대부분의 도구는 요약을 거치며 엣지 케이스나 결정 이유 같은 핵심 정보를 유실합니다. MemPalace는 원본을 유지하면서 그 위에 컴팩트한 인덱스를 쌓아 검색 정확도를 높입니다. 특히 시간 개념을 메모리에 도입하여 시간이 지남에 따라 변하는 소프트웨어 결정 사항을 효과적으로 관리합니다.

활용 시 주의사항 및 결론

  • 로컬 데이터베이스이므로 백업, 정리, 마이그레이션과 같은 직접적인 유지 관리가 필요합니다.
  • 사칭 도메인이 존재하므로 GitHub 공식 저장소 및 파이썬 패키지를 통해서만 설치해야 합니다.
  • 프로젝트 규모가 작거나 호스팅된 간편 서비스를 선호하는 경우에는 부적합합니다.

관리자 대시보드나 권한 설정 기능은 아직 부족하므로 개발자가 직접 데이터베이스를 관리해야 합니다. 사칭 사이트를 통한 보안 위험을 피하기 위해 반드시 공식 경로를 확인해야 하며, 로컬 우선 도구를 선호하는 개발자에게 가장 최적화되어 있습니다.

Community Posts

No posts yet. Be the first to write about this video!

Write about this video