CategoryWeightCategory scoreContribution
Securityprompt, exec, net, exfil, eval
35%
35.0 pts
Supply chainhash, typosquat, maintainer, lockfile
20%
20.0 pts
Maintenancestaleness, pinning, CI
15%
15.0 pts
TransparencySKILL.md, perms, README
15%
15.0 pts
Communityinstalls, verify, response
15%
15.0 pts
Findings & checks · 0 flagged
Security
✓—All security checks passedNo findings in this category for the latest scan.pass
Supply chain
✓—All supply chain checks passedNo findings in this category for the latest scan.pass
Maintenance
✓—All maintenance checks passedNo findings in this category for the latest scan.pass
Transparency
✓—All transparency checks passedNo findings in this category for the latest scan.pass
Community
✓—All community checks passedNo findings in this category for the latest scan.pass
Every scanned point with the score it earned and what moved between them.
5d0ea68
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
memmd-mcp
<p align="center"> <img src="assets/memmd-mcp.webp" alt="memmd-mcp" width="600"> </p>
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.
[!TIP] Why memmd? - One memory, every client — Claude Desktop, Cursor, Claude Code, OpenAI Codex share the samememory.md- Zero external dependencies beyondmcp— no embeddings, no API keys, fully offline - Deterministic, rule-based — no LLM calls for memory management - Human-readablememory.md— inspect and edit anytime
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-mcpAdd 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.jsonor user settings - Cursor —~/.cursor/mcp.json- OpenAI Codex —~/.codex/config.toml
Tools
| Tool | Description |
|---|---|
remember(content, category?) | Store with auto-dedupe and contradiction merge |
recall(query) | Search with keyword scoring and category filters |
forget(id) | Delete by ID |
summarize() | Category overview + stale entry cleanup |
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
| Variable | Default | Description |
|---|---|---|
MEMMD_MEMORY_PATH | ./memory.md | Path to memory file |
MEMMD_STALE_DAYS | 120 | Days before stale cleanup (min: 7) |
License
MIT