memo-mcp

memo-mcp는 프라이빗하고 자체 호스팅되는 Mem0 REST API를 위한 보호된 Streamable HTTP MCP 게이트웨이입니다. Mem0, PostgreSQL 및 내부 API 자격 증명을 공용 네트워크로부터 격리하면서 작고 비파괴적인 메모리 도구 표면을 제공합니다.

이 프로젝트는 하나의 신뢰된 메모리 범위를 위한 참조 구현으로 설계되었습니다. 여러 사람이 사용하기 전에 인증된 신원에서 메모리 범위를 도출하는 서버 측 정책 어댑터를 통합하세요. 브라우저나 MCP 클라이언트가 MEMORY_SCOPE를 선택하도록 허용하지 마세요.

보안 모델

• Mem0는 프라이빗하게 유지되며, 리버스 프록시를 통해 이 게이트웨이만 노출하세요.

• 브라우저가 아닌 클라이언트는 별도의 해지 가능한 베어러 토큰을 사용합니다.

• 브라우저 클라이언트는 발급자(issuer), 대상(audience), 불변 주체(subject) 및 범위(scope)를 정확히 검증하는 OAuth/OIDC 토큰 인트로스펙션을 사용할 수 있습니다.

• memo_remember_fact는 OAuth 클라이언트에 대해 mem0.write 범위를 요구합니다.

• 이 게이트웨이는 의도적으로 메모리 삭제 도구를 제공하지 않습니다. 삭제는 명시적 승인을 거친 별도의 프라이빗 관리 워크플로를 통해 수행하세요.

• 게이트웨이는 자격 증명 및 개인 키 형식이 메모리에 기록되기 전에 이를 거부합니다. 이는 안전망이지 운영자 정책을 대체하는 것이 아닙니다.

• 호출자는 절대 자신의 메모리 범위를 선택해서는 안 됩니다. 다중 사용자 환경에서는 신뢰할 수 있는 애플리케이션이 서버 측 멤버십에서 해당 범위를 도출해야 합니다.

Related MCP server: memex

빠른 시작

1. .env.example을 .env로 복사하고 모든 플레이스홀더를 자신만의 값으로 바꾸세요. .env를 커밋하지 마세요.

2. 프라이빗 Docker 네트워크를 만들고 docker compose -f compose.example.yml up -d --build로 서비스를 시작하세요.

3. HTTPS로는 게이트웨이만 라우팅하세요. Mem0, PostgreSQL 또는 값이 채워진 환경 파일을 노출하지 마세요.

4. OAuth가 활성화되었을 때 protected-resource 메타데이터가 200을 반환하고, 익명의 /mcp 요청이 401을 반환하는지 확인하세요.

도구

• memo_search_memory

• memo_remember_fact

설정

.env.example을 참조하세요. PUBLIC_MCP_URL, MCP_ALLOWED_HOSTS, MCP_ALLOWED_ORIGINS은 자신의 HTTPS 엔드포인트를 가치가 있어야 합니다. 게이트웨이는 X-API-Key를 사용해 요약되지 않은 Mem0 API를 호출합니다.

MCP_ALLOWED_HOSTS는 필수입니다. 컨테이너 빌드 컨텍스트는 .env, Git 메타데이터 및 로컬 Python 산출물을 제외하므로 이미지에 실수로 복사되지 않습니다.

개발

python -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt
python -m unittest discover -s tests -v

이 프로젝트는 공식적으로 Python MCP SDK를 사용합니다.