mcp-memory

Smart memory for AI agents. Memories decay, topics are frequency-weighted, one-time questions don't become obsessions.

Solves [the Karpathy problem](https://x.com/karpathy/status/2036836816654147718): "A single question from 2 months ago keeps coming up as a deep interest with undue mentions in perpetuity."

Day 1: User asks 5 questions (Rust, dark mode, Python, job title, Haskell)

  #1 [ACTIVE] rel=1.000 cat=preference "User prefers dark mode in all editors"
  #2 [ACTIVE] rel=0.900 cat=fact       "User works as a senior software engineer"
  #3 [FADING] rel=0.500 cat=question   "User is building a Python web scraper"
  #4 [FADING] rel=0.300 cat=one-time   "User asked about Rust programming"
  #5 [FADING] rel=0.300 cat=one-time   "User asked what Haskell monads are"

Day 2-5: User mentions Python 4 more times → auto-upgraded to "interest"

  #1 [ACTIVE] rel=2.658 mentions=5 cat=interest    "Python web scraper"
  #2 [ACTIVE] rel=1.000 mentions=1 cat=preference  "dark mode"
  #3 [ACTIVE] rel=0.900 mentions=1 cat=fact         "senior software engineer"
  #4 [FADING] rel=0.300 mentions=1 cat=one-time     "Rust" ← FADING, won't obsess
  #5 [FADING] rel=0.300 mentions=1 cat=one-time     "Haskell" ← FADING, won't obsess

After 60 days:
  Rust:   0.3 × 0.5^(60/7) = 0.0008 → DEAD (gone, as it should be)
  Python: 0.8 × 0.5^(60/60) × 3.32 = 1.329 → STILL ACTIVE (real interest)

| Current LLM Memory | mcp-memory | |---------------------|------------| | Ask about Rust once → mentioned forever | Ask once → fades in 7 days | | All memories equal weight | Categories: one-time (7d), question (14d), interest (60d), preference (180d) | | No decay | Exponential decay — old memories naturally fade | | No frequency tracking | Mentioned 5+ times → auto-upgrades from "question" to "interest" | | Keyword matching | Relevance scoring: decay × frequency × match quality |

"mcpServers": {
  "memory": {
    "com