memmd-mcp

A memory layer for AI agents — local memory.md with automatic deduplication, contradiction resolution, and stale cleanup.

[!TIP] Why memmd?

• Zero external dependencies beyond mcp — no embeddings, no API keys, fully offline
• Deterministic, rule-based — no LLM calls for memory management
• Human-readable memory.md — inspect and edit anytime
• Works with Claude Desktop, Cursor, Claude Code, and any MCP client

Features

• Deduplication — fingerprint + Jaccard similarity merges near-identical entries
• Contradiction resolution — detects conflicting facts, keeps latest, archives old
• Structured categories — Work Context · Projects · Personal Preferences · Archive
• Section-aware recall — filter by category, keyword search with scoring
• Stale cleanup — auto-archives old, unused entries on summarize()
• Korean support — category aliases, fact patterns (~는 ~), stopwords

Quick Start

Install and run

uvx memmd-mcp

Add to your MCP client

{
  "mcpServers": {
    "memmd": {
      "command": "uvx",
      "args": ["memmd-mcp"],
      "env": {
        "MEMMD_MEMORY_PATH": "/absolute/path/to/memory.md"
      }
    }
  }
}

[!NOTE] Config location by client:

• Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json
• Claude Code — .claude/settings.json or user settings
• Cursor — Cursor MCP settings

Tools

How It Works

remember

• Dedupes by SHA-1 fingerprint and Jaccard similarity (>0.82)
• Extracts facts from key: value, key = value, key is value, key는 value
• On conflict: latest value wins, old entry archived with history

recall

• Keyword search with token-overlap scoring
• Filters: category:Projects API token, section:"Work Context" deploy
• Korean aliases accepted (category:프로젝트)

summarize

• Per-category summary of recent entries
• Archives stale entries (default: >120 days, <3 accesses, no recent recall)

memory.md Format

# memory.md

<!-- memmd:version=1 -->

## Work Context
<!-- memmd-entry {...json...} -->
Memory content

## Projects
...

## Personal Preferences
...

## Archive
...

Environment Variables

Development

uv sync
uv run memmd-mcp          # run locally
uv build && uv publish    # publish to PyPI

License

MIT

Language docs: 한국어