Claude.md는 컨텍스트를 위한 것이고, MarsNMe는 연속성을 위한 것입니다.

MarsNMe는 AI에게 세션 간의 연속성(Continuity)을 부여하는 오픈 소스 기반의 에이전트 불가지론적 (agent-agnostic) 메모리 백엔드입니다. 이는 단순한 컨텍스트 주입 (context injection)을 넘어, 성장하는 관계를 구축합니다. 우리가 이를 어떻게 구축했는지 소개합니다.

문제점 (The Problem)

AI 어시스턴트와 새로운 대화를 시작할 때마다, AI는 모든 것을 잊어버립니다. 당신의 선호도, 프로젝트, 컨텍스트가 모두 사라집니다.

대부분의 메모리 솔루션은 다음과 같은 문제를 가지고 있습니다:

• 하나의 AI 제공업체(provider)에 종속됨
• 메모리를 단순한 키-값 (key-value) 쌍으로 저장함 (의미론적 검색 (semantic search) 불가)
• 자체 호스팅을 위해 복잡한 인프라가 필요함

우리는 다른 것을 원했습니다.

아키텍처 (The Architecture)

MarsNMe는 모든 MCP 호환 클라이언트가 연결할 수 있는 **스트리밍 가능한 HTTP MCP 서버 (Streamable HTTP MCP server)**입니다. 단 한 번의 npx 명령과 하나의 .env 파일만 있으면 당신의 AI는 메모리를 갖게 됩니다.

MCP_PROFILE=my-agent npx @marsnme/mcp-gateway

스택 (Stack)

계층 (Layer)	기술 (Tech)
프로토콜 (Protocol)	MCP (Streamable HTTP)
...

2단계 메모리 모델 (Two-tier Memory Model)

• 단기 메모리 (Short-term): <profile>.memories — 일상적인 컨텍스트, 30일 후 만료
• 장기 메모리 (Long-term): <profile>.marsvault_chunks — 정제된 통찰 (distilled insights), 의미론적 회상 (semantic recall)

단기 메모리는 모든 것을 포착합니다. 장기 메모리는 에이전트(또는 우리의 Dream Runner를 통해)에 의해 명시적으로 승격됩니다.

멀티 프로필 격리 (Multi-Profile Isolation)

하나의 게이트웨이, 다수의 에이전트. 각 MCP_PROFILE은 자신만의 Supabase 스키마 (schema)를 가집니다:

MCP_PROFILE=coco npx @marsnme/mcp-gateway   # port 18790
MCP_PROFILE=toto npx @marsnme/mcp-gateway   # port 18791

교차 오염(cross-contamination)이 없으며, 테이블을 공유하지 않습니다.

13가지 MCP 도구 (The 13 MCP Tools)

도구 (Tool)	기능
session_boot	세션 시작 시 컨텍스트 사전 로드
...

가장 어려웠던 부분 (The Hardest Part)

가장 어려웠던 부분은 임베딩 (embeddings)이나 저장소가 아니었습니다. 그것은 바로 AI 어시스턴트에게 언제 저장하고 언제 회상해야 하는지를 가르치는 것이었습니다.

우리는 결국 모든 대화의 시작 시점에 실행되어 가장 관련성 높은 기억들을 자동으로 주입하는 session_boot 도구를 작성하게 되었습니다. 에이전트는 이에 대해 별도로 생각할 필요가 없습니다.

사용해 보기

# 1. .env 설정 (Supabase + Jina 키)
cp .env.example .env

...

향후 계획

• LobeHub 마켓플레이스 등록
• Smithery 레지스트리 등록
• 웹 기반 "Try it" 데모 (설치 불필요)

GitHub: https://github.com/Marsmanleo/MarsNMe
Website: https://marsnme.com
npm: npx @marsnme/mcp-gateway
License: Apache 2.0

Mars Group 제작. 인간과 AI가 함께 성장할 수 있도록 설계되었습니다.