AI代理共享内存层

一个为AI代理设计的共享内存层,支持自动去重、矛盾解决和旧数据清理,适用于Claude Desktop、Cursor、Claude Code、OpenAI Codex等客户端。

  • by matamong
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 matamong/memmd-mcp

使用说明

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)

许可证

麻省理工学院