memmd-mcp
  
AI代理的共享内存层——一个 memory.md 在Claude Desktop、Cursor、Claude Code、OpenAI Codex和任何MCP客户端之间同步。包括自动重复数据删除、矛盾解决和过时清理。
\[!提示\] 为什么选择memmd? - 一个记忆,每一个客户 --Claude Desktop、Cursor、Claude Code、OpenAI Codex共享相同内容memory.md- 零外部依赖mcp-没有嵌入,没有API密钥,完全脱机 - 确定性、基于规则——无需LLM调用内存管理 - 人类可读memory.md--随时检查和编辑
特性
- 去重 --指纹+Jaccard相似性合并了几乎相同的条目
- 矛盾解决 --检测相互矛盾的事实,保持最新,存档旧
- 结构化类别 --工作环境·项目·个人偏好·档案
- 节意识召回 --按类别筛选,关键字搜索并评分
- 旧物清理 --自动存档旧的、未使用的条目
summarize() - 韩国支持 --类别别名、事实模式(
~는 ~),停用词
快速开始
安装并运行
uvx memmd-mcp添加到您的MCP客户端
{
"mcpServers": {
"memmd": {
"command": "uvx",
"args": ["memmd-mcp"],
"env": {
"MEMMD_MEMORY_PATH": "/absolute/path/to/memory.md"
}
}
}
}\[!注意\] 按客户端配置位置: - 克劳德桌面版 —~/Library/Application Support/Claude/claude_desktop_config.json- 克劳德代码 —.claude/settings.json或用户设置 - 光标 —~/.cursor/mcp.json- OpenAI Codex —~/.codex/config.toml
工具
| 工具 | 说明 |
|---|---|
remember(content, category?) | 具有自动重复数据消除和矛盾合并功能的存储 |
recall(query) | 使用关键字评分和类别过滤器进行搜索 |
forget(id) | 按ID删除 |
summarize() | 类别概述+过时条目清理 |
运作原理
remember
- 根据SHA-1指纹和Jaccard相似度(>0.82)进行推断
- 从中提取事实
key: value,key = value,key is value,key는 value - 关于冲突:最新价值获胜,旧条目与历史一起存档
recall
- 使用令牌重叠评分进行关键字搜索
- 过滤器:
category:Projects API token,section:"Work Context" deploy - 接受韩语别名(
category:프로젝트)
summarize
- 最近参赛作品的分类摘要
- 存档过期条目(默认值:>120天,\
Work Context
Memory content
Projects
...
Personal Preferences
...
Archive
...
## 环境变量
|变量|默认值|描述|
|---|---|---|
| `MEMMD_MEMORY_PATH` | `./memory.md` |内存文件路径|
| `MEMMD_STALE_DAYS` | `120` |过期清理前几天(分钟:7)|
## 许可证
麻省理工学院