🏛️ MemPalace：52k Stars 的开源 AI 记忆系统，96.6% 检索召回率且零 API 调用

项目地址：github.com/MemPalace/mempalace | ⭐ 52,431 Stars | 🛠 Python | 作者 MemPalace

老实说，AI Agent 的记忆问题一直是个痛点。Mem0、Mastra、Zep 各玩各的，召回率吹得天花乱坠，但你一翻 benchmark 发现大家都是不同数据集上自嗨。直到 MemPalace 出来——96.6% R@5 召回率，零 LLM 调用，零 API Key，本地跑，还开源。

一、不是记忆摘要，是原话存储

市面上大多数记忆系统干了同一件事：把对话内容 summarize 成摘要存起来。问题是——摘要必然丢信息。你昨天说的"把 user_id 改成 UUID"，今天 search 的时候可能只匹配到"改 ID"。

MemPalace 反着来：原话存储（verbatim text），不做任何摘要、提取、改写。搜索的时候用语义检索找原始文本。

架构分了三层——Wings（翼） 对应项目/人，Rooms（房间） 对应主题，Drawers（抽屉） 存原始内容。这样搜索可以限定范围而不是在平铺的语料库里瞎翻。

二、一行命令装好

# 推荐用 uv
uv tool install mempalace
mempalace init ~/projects/myapp

# 或者 pip
pip install mempalace

三、本地搜自己的代码和对话

# 索引项目文件
mempalace mine ~/projects/myapp

# 索引 Claude Code 会话（用 --wing 按项目分组）
mempalace mine ~/.claude/projects/ --mode convos --wing myapp

# 搜索
mempalace search "为什么我们选了 GraphQL 而不是 REST"

# 加载上下文准备新会话
mempalace wake-up

最骚的操作是 mempalace wake-up——它会把跟当前项目最相关的历史上下文自动注入到你的 prompt 里，新开一个 Claude Code 会话，前面聊了啥全都记得。

四、Benchmark 数据（全部可复现）

LongMemEval 500 问，纯语义搜索（无启发式、无 LLM）做到 96.6% R@5。Hybrid v4 加了关键词 boosting 和时间 proximity boosting，held-out 450 问做到 98.4%。再加一层 LLM rerank（随便用个 Haiku 级别的）直接 ≥99%。

LoCoMo 上 hybrid v5 做到 88.9% R@10，ConvoMem 平均召回 92.9%，MemBench（ACL 2025, 8,500 items）做到 80.3% R@5。

一句话：不用喂 token 给 LLM 去总结，直接搜原文，效果反而更好。

五、MCP Server + Claude Code Hook

MemPalace 提供了 29 个 MCP 工具，覆盖 palace 读写、知识图谱操作、跨翼导航、抽屉管理。安装方式：

{
  "mcpServers": {
    "mempalace": {
      "command": "uvx",
      "args": ["mempalace", "mcp"]
    }
  }
}

Claude Code 用户还能配 auto-save hook，在 context 压缩前自动存档：

mempalace install-hook ~/.claude/projects/myapp

六、踩坑记录

1. ChromeDB 是默认后端，但接口是插件化的——mempalace/backends/base.py 里定义了抽象层，你可以换 Postgres + pgvector 或者其他向量库
2. 首次 mine 大项目会慢，因为要下载 embedding 模型（~300MB），跑完一次之后增量更新就很快了
3. Claude Code 会话 30 天无操作自动过期——如果没配 auto-save hook，历史就丢了。别问我怎么知道的

七、总结

• 原话存储而不是 summarize，召回率更高
• 96.6% R@5 不需要任何 LLM 调用
• 本地运行，数据不出机器
• 29 个 MCP 工具，Claude Code / Gemini CLI 都支持
• uv tool install 一分钟搞定

别再用那些要你充 API Key 的"AI 记忆"服务了。自己跑一个 MemPalace，数据在自己手里，效果还更好。

标签：#AI #Memory #OpenSource #MCP #ClaudeCode #DeveloperTools