MemPalace/mempalace

项目概览

项目报告其在 LongMemEval 上取得 96.6% 的原始 R@5，且该结果不依赖大语言模型或接口调用。

项目类型

MCP · AI Agent · RAG 与知识库

应用场景

知识问答 · 编程开发

部署方式

查看项目说明

License

MIT

适合谁

• 适合重视原始会话表述、希望避免摘要改写，并需要在多次人工智能编码会话之间检索历史上下文的开发者。
• 适合要求数据保留在本地、希望自行部署，并需要通过命令行或模型上下文协议接入记忆能力的团队。

核心能力

• 将对话历史和内容以原始文本保存，不进行摘要或改写。该能力当前可用，价值在于后续检索仍能返回原始会话表述。
• 支持在翼、房间和抽屉等结构化记忆范围内执行搜索。该能力当前可用，可用于缩小查询范围并取回相关文本上下文。
• 通过接口契约替换检索后端，已列出的选项包括 ChromaDB、SQLite 和 Milvus 等。该能力当前可用，便于根据既有数据组件选择后端。
• 通过模型上下文协议提供 36 个工具，覆盖记忆宫殿读写、图谱操作和代理管理。该能力当前可用，可供支持该协议的客户端调用这些操作。
• 使用本地 SQLite 保存实体关系图，并为关系记录有效时间窗口。该能力当前可用，适合表达会随时间变化的实体关系。
• 为 Claude Code、Codex CLI 和 Cursor IDE 提供钩子，用于定期保存会话。该能力当前可用，可减少依赖用户手动触发保存的情况。

限制与风险

• 若要获得项目所述最高准确度，大语言模型重排需要外部具备相应能力的模型；选型时应单独确认该模型的可用性。
• 运行需要 embeddinggemma-300m 或 all-MiniLM-L6-v2，并需为嵌入模型准备约 300 MB 磁盘空间。
• 项目当前提供本地自行部署方式，没有托管服务。
• 现有资料未记录遥测设置，部署前需要自行核查实际版本的相关行为。

如何开始

• 可先执行 uv tool install mempalace 安装工具，再以 mempalace init ~/projects/myapp 初始化目标项目，最后指向目标路径执行 mempalace mine ~/projects/myapp。

核验依据

• GitHub 项目简介: The best-benchmarked open-source AI memory system. And it's free.
• README: Claude Code sessions expire in 30 days without auto-save hooks wired.
• README: MemPalace stores your conversation history as verbatim text and retrieves it with semantic search. It does not summarize, extract, or paraphrase.
• README: ChromaDB is the default and needs no configuration. MemPalace also ships a pluggable backend contract
• README: 36 MCP tools cover palace reads/writes, knowledge-graph operations, cross-wing navigation, drawer management, and agent diaries.

内容核验时间：