Easy Memory
Easy Memory
MCP persistent memory service — let AI assistants remember across sessions.
Key Features
4 MCP Tools: memory_save, memory_search, memory_forget, memory_status
Hybrid Retrieval: Vector similarity (Qdrant) + BM25 keyword scoring for best-of-both-worlds search
Dual Embedding: Local Ollama (bge-m3) + Cloud Gemini with automatic failover & circuit breaker
Content Deduplication: SHA-256 based dedup prevents redundant memory entries
Sensitive Data Redaction: Auto-redacts AWS keys, JWT tokens, PEM keys, DB connection strings
Dual-Shell Architecture: MCP stdio for IDE integration + HTTP REST for remote access
Web Admin Panel: Real-time dashboard, user management, API key management, audit logs, analytics
Multi-User Auth: Role-based access (admin/user), per-user API keys with rate limiting
Remote Proxy Mode: No local Qdrant/Ollama needed — connect to a remote Easy Memory server
Quick Start
Option A: Remote Mode (Recommended — No Docker Required)
Set EASY_MEMORY_URL and EASY_MEMORY_TOKEN to connect to a remote server. No local infrastructure needed.
Option B: Local Mode (Full Stack)
Requires Docker for Qdrant + Ollama:
bash Start dependencies docker compose up -d qdrant ollama Run via npx npx easy-memory@latest
Supported Clients
Claude Desktop · Cursor · VS Code (GitHub Copilot) · JetBrains IDEs · Any MCP-compatible client
Links
GitHub: https://github.com/FlippySun/easy-memory
npm: https://www.npmjs.com/package/easy-memory
Docker Hub: https://hub.docker.com/r/thj8632/easy-memory
User Guide: https://github.com/FlippySun/easy-memory/blob/main/USER_GUIDE.md
Server Config
{
"mcpServers": {
"easy-memory": {
"command": "npx",
"args": [
"-y",
"easy-memory@latest"
],
"env": {
"EASY_MEMORY_URL": "https://memory.zhiz.chat/mcp",
"EASY_MEMORY_TOKEN": "<YOUR-TOKEN Get By: https://memory.zhiz.chat/>"
}
}
}
}