memmd-mcp

English | 한국어

A shared memory layer for AI agents — one memory.md synced across Claude Desktop, Cursor, Claude Code, OpenAI Codex, and any MCP client. Auto-deduplication, contradiction resolution, and stale cleanup included.

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

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

License

MIT