Skip to content

v0.1.0 — Initial release

Choose a tag to compare

View all tags
@kid-sid kid-sid released this 15 May 15:48
· 19 commits to main since this release
v0.1.0
84ce004

memory-map-mcp v0.1.0

First public release of the MCP server for persistent AI memory and conversation history in Claude Code.

Install

pip install memory-map-mcp
claude mcp add -s user memory_map -- memory-map-mcp

What's included

  • 21 MCP tools — save/load/delete memory, conversation history, project structure, git history, cross-project search, compression, global memory, migration
  • MongoDB-backed storage — key-value memory and conversation history stored in memory_map.memory and memory_map.history collections
  • File fallback — key-value memory falls back to .mcp_memory.json when MongoDB is not configured
  • Hybrid retrieval — BM25 + optional vector search (OpenAI or local sentence-transformers) merged via RRF, re-ranked with MMR
  • Secret redaction — API keys, MongoDB URIs, AWS keys, GitHub PATs redacted before storage
  • Auto-migration — existing .mcp_memory.json files migrated to MongoDB automatically on first connection
  • memory-map-hook — standalone Claude Code hook for automatic history capture on every Q&A pair

Optional extras

pip install "memory-map-mcp[embed-openai]"   # OpenAI vector search
pip install "memory-map-mcp[embed-local]"    # Local CPU vector search (no API key)

Environment variables

Variable Purpose
MEMORY_MAP_MONGO_URI MongoDB connection string (required for history)
MEMORY_MAP_EMBED_PROVIDER openai, local, or atlas for vector search
OPENAI_API_KEY Required when EMBED_PROVIDER=openai

Full documentation: https://github.com/kid-sid/memory_map

Assets 2
Loading