Easy Memory

@FlippySun

Visit Server

2 months ago

MCP persistent memory service that gives AI assistants long-term memory across sessions and projects. Powered by Qdrant vector search + Ollama/Gemini embedding with hybrid retrieval (vector + BM25). Features include: semantic memory save/search/forget, content deduplication via SHA-256, automatic sensitive data redaction, dual-shell architecture (MCP stdio + HTTP REST), Web Admin Panel with analytics, multi-user auth & API key management, and audit logging.

Overview Tools Comments

Overview

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

Try in Playground

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/>"
      }
    }
  }
}

Build with ShipAny.