使用说明
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天,<3次访问,最近没有召回)
memory.md 格式
# memory.md
<!-- memmd:version=1 -->
## Work Context
<!-- memmd-entry {...json...} -->
Memory content
## Projects
...
## Personal Preferences
...
## Archive
...
环境变量
| 变量 | 默认值 | 描述 |
|---|---|---|
MEMMD_MEMORY_PATH |
./memory.md |
内存文件路径 |
MEMMD_STALE_DAYS |
120 |
过期清理前几天(分钟:7) |
许可证
麻省理工学院
