MemPalace 记忆库

把对话和项目资料原文存入本地记忆库,并用语义搜索为 AI 会话找回相关内容。

Star 数
★ 60k
最近更新
今天
License
MIT
主语言
Python

30 秒速览

运行形态
命令行工具MCP 服务器Agent 插件 / 技能
可在哪里用
通用 · 跨平台Codex · Claude CodeOpenAI API · Claude API(部分支持)
费用
软件免费,模型调用费用自付
上手难度
中 · 需要几步配置
开始前需要
Python 3.10+ChromaDBDocker(可选)Shell / 命令行网络访问本地文件系统MCP Server
典型场景
使用 Claude Code 的开发者,希望将历史会话导入本地并在后续会话中搜索。
不适合
  • 需要 Android 原生 Termux 安装的用户
  • 要求所有检索与重排都不使用外部模型服务的团队

这个 Agent 能做什么,适合哪些场景?

MemPalace 是一个本地优先的 AI 记忆系统,将对话历史和项目文件按原文存储,不做摘要、提取或改写。默认使用 ChromaDB,通过语义搜索检索内容,并以 wing、room 和 drawer 组织人员、项目、主题与原始资料。用户可用 CLI 导入和搜索资料,也可通过 MCP server 让兼容客户端读取和管理记忆;Python API 也有文档说明。系统支持多个可选存储后端,并包含基于本地 SQLite 的时序实体关系图。默认检索和基准测试路径不需要 LLM 或 API 密钥,但首次使用嵌入模型需要下载;可选的 LLM 重排或远程嵌入服务会引入相应模型或服务依赖。

使用 mempalace mine 从项目文件或 Claude Code 会话读取内容,并将原文存入 palace;mempalace search 按语义查找相关记忆,mempalace wake-up 为新会话加载上下文。用户可通过 mempalace audit 检查记忆库组织情况。MCP server 提供记忆库读写、知识图谱、跨 wing 导航、drawer 管理、agent 日记和协调工具。系统还提供 mempalace sweep,可将对话逐条保存为原文 drawer;选择启用 LLM 重排时,会用模型重新排序检索到的候选内容。

  1. 使用 Claude Code 的开发者,希望将历史会话导入本地并在后续会话中搜索。
  2. 需要跨项目找回决策或技术讨论的工程团队,可按项目 wing 和主题 room 管理原文。
  3. 使用 MCP 客户端的开发者,希望让助手读取或更新本地记忆库。
  4. 需要把项目目录内容建立语义索引、再用自然语言问题检索的个人或团队。
  5. 希望在本地维护带有效时间范围的实体关系信息,并用 SQLite 查询时间线的用户。

如何安装或部署这个 Agent?

推荐用 uv 将 CLI 安装在隔离环境中;初始化 palace 后即可导入项目内容。也可用 pipx 安装,或在已激活的虚拟环境中用 pip 安装。首次需要嵌入的操作会下载所选模型。若使用 Docker,需要将持久化目录挂载到 /data;MCP 客户端配置示例如下:

uv tool install mempalace
mempalace init ~/projects/myapp

Docker MCP server 配置:

{
  "mcpServers": {
    "mempalace": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "mempalace-data:/data",
        "-v", "/absolute/path/to/.claude/projects:/transcripts:ro",
        "ghcr.io/mempalace/mempalace"
      ]
    }
  }
}

如何使用这个 Agent?

将项目文件或 Claude Code 会话导入 palace,然后按问题检索;新会话可加载已有上下文。会话目录和项目路径需替换为实际路径。Claude Code 会话示例:

mempalace mine ~/projects/myapp
mempalace mine ~/.claude/projects/ --mode convos
mempalace search "why did we switch to GraphQL"
mempalace wake-up
mempalace audit

这个 Agent 有哪些优点和局限?

优点
  • 默认保存对话原文,支持语义搜索,不依赖摘要来保留细节。
  • 默认 ChromaDB 可本地运行;README 报告 LongMemEval 原始检索在 500 道题上达到 96.6% R@5,且该路径无需 LLM。
  • 存储后端可选 ChromaDB、sqlite_exact、rust_exact、Milvus、Qdrant 和 pgvector。
  • 提供 MCP 工具、CLI、Python API,以及面向 Claude Code 和 Codex CLI 的自动保存 hooks。
局限
  • 需要 Python 3.10+;默认嵌入模型需要下载,README 提到模型占用约 30 MB 或约 300 MB。
  • Android 原生 Termux 安装不受支持;Android ARM64 用户需使用 Debian PRoot 容器。
  • 部分后端需要额外安装或配置服务;启用远程嵌入或 LLM 重排还需相应服务或模型。
  • Docker Linux bind mount 的目录必须能被镜像内 uid 1000 读取;本地原生安装也需要管理 palace、配置和模型文件。

这个 Agent 与同类方案有什么区别?

README 将 ChromaDB 描述为默认后端,并列出 sqlite_exact、rust_exact、Milvus、Qdrant 和 pgvector 作为可选后端。项目未提供与 Mem0、Mastra、Hindsight、Supermemory 或 Zep 的可比基准,因此不据此作性能排名。

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
MemPalace 记忆库 当前 74 · 存在缺口 命令行工具免费 + 模型费 ★ 60k 今天 Python Codex · Claude Code
Remnic 智能体记忆 85 · 表现良好 命令行工具免费 + 模型费 ★ 228 1 天前 TypeScript ChatGPT · Codex · Claude Code · OpenAI API
Ori Mnemos 80 · 表现良好 命令行工具免费 ★ 331 19 天前 TypeScript Claude Code · OpenAI API · Claude API
GraphMind 代码知识图谱 64 · 存在缺口 桌面应用免费版 + 付费版 ★ 216 5 天前 Rust Claude Code · Claude.ai

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
存在缺口
74/ 100 五分制 3.7 / 5
信任安全 19/29
可靠稳定 9/14
适用触发 16/18
规范维护 14/18
有效结果 10/13
证据核验 6/8
查看各维度的扣分理由
信任安全19 / 29 · 3.3/5

README 说明默认本地存储、可选远程嵌入、容器挂载边界和只读挖掘;升级检查默认关闭且需要用户授权。不过 MCP 提供大量读写与协调工具,敏感记忆没有显示加密或细粒度访问控制,因此最小权限、敏感数据处理和外部副作用未满分。安全策略给出私下报告渠道,README 与 authored-at 文档也说明来源时间字段及其局限;但维护责任和发布者身份并不清楚,不能据此进一步加分。

可靠稳定9 / 14 · 3.2/5

README、配置和 CI 文件共同说明多后端、平台支持、依赖及测试门槛;CI 也披露 Windows 上特定 Chroma 瞬时故障并限定重试。常见依赖有版本范围而非完全锁定,错误提示证据主要是安装说明中的具体故障示例,尚不足以证明全面的运行时诊断,因此均为良好但非满分。

适用触发16 / 18 · 4.4/5

文档覆盖开发者、对话记忆、项目文件、MCP、Docker、团队服务、不同向量后端和多平台;明确指出哪些后端需选装、哪些能力有回退、GPU 镜像的架构限制及 Claude 自动保存前提。三个技能的用途和设置触发路径有说明,但未提供技能正文来证明所有触发条件都足够精确。

规范维护14 / 18 · 3.9/5

README 按安装、后端、快速开始、基准、工具和文档组织,命令与环境变量示例丰富,并明确列出 Termux、ARM GPU 等限制;MIT 许可文本完整。版本号可从多个文件核对,变更日志有链接但未在所给材料中展示;FAQ 和维护者责任也没有充分材料,故不满分。

有效结果10 / 13 · 3.8/5

CLI、MCP、结构化记忆和搜索结果字段可直接用于日常操作;README 给出多组基准数值及复现入口,并避免不等指标的跨项目比较。相对价值主要由项目自身声明和所引用的结果文件支持,所给材料没有结果文件或对照复核;成本信息指出模型下载和本地磁盘需求,但没有完整的资源成本测量。

证据核验6 / 8 · 3.8/5

README 将基准、结果文件、复现命令和方法文档相互指引;authored-at 文档清楚区分导入时间、推断日期和可验证作者日期,并给出示例与回填步骤。证据链较清晰,但本次材料未包含基准结果文件、完整变更日志或技能正文,因而跨来源印证只能给部分分。

风险与缓解建议
  • 基准数字来自项目 README 和其指向的仓库材料;本次静态审查未运行复现流程,也未独立核验结果。
  • 记忆库可能包含敏感对话;所给文件未说明静态加密或细粒度访问控制。远程嵌入、模型下载和服务端后端会改变数据流,应按配置确认边界。
证据充分度:低 评估于 2026年10月20日 审查版本 f884dd4c0824
查看完整评分方法 →

常见问题

使用核心检索是否需要 API 密钥或付费模型?
不需要。README 所述原始语义检索基准路径无需 API 密钥或 LLM。LLM 重排和远程嵌入是可选路径,可能需要对应的模型或服务。
数据会离开本机吗?
README 说明默认情况下数据不会离开本机,除非用户选择启用外部服务。远程嵌入端点会收到用于嵌入的内容;使用 LLM 重排时,候选内容也会交给所配置的模型。
首次使用为什么可能比较慢?
首次需要生成嵌入时会下载模型:README 提到默认 minilm 约 80 MB 的容器缓存模型大小,另一处将其列为约 30 MB;embeddinggemma 约 300 MB。首次下载需要网络。
能否直接安装到 Android 的 Termux?
不支持原生 Termux 安装,因为相关编译依赖发布 Linux wheel 而非 Android wheel。Android ARM64 用户可按文档在 Debian PRoot 容器中运行 Linux 包。
怎样让 Claude Code 会话持续保存?
README 提醒,如果未配置自动保存 hooks,Claude Code 会话会在 30 天后过期。它提供 hooks 配置说明,并建议备份已有 JSONL transcripts 后导入。
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关 Agents