Mnemosyne：AI Agent 长期记忆系统

30 秒速读：Mnemosyne 是一套本地优先的 AI Agent 长期记忆系统：所有记忆、来源证据和时间历史都存在单个 SQLite 文件里，Agent 跨会话需要”记住”的东西——事实、经验、任务交接上下文——都从这里读写。它通过 MCP Server、TypeScript SDK、CLI 和 HTTP 四种方式接入，MCP 工具覆盖存储、召回、纠正、检查点等环节。适合给本地或单机 Agent 加一个可追溯、可纠错的”外置大脑”；要分布式集群或托管服务的话，它不是那个路子。

软件信息一览

版本选择：Release 预构建 vs 源码运行

结论先行：只想用，选 Release 预构建；要改、要调、要看实现，再走源码运行。

部署的关键步骤

1. 确认 Node.js 版本 ≥ 22.16（运行 node -v 查看），低版本会直接起不来——这是最常见的卡点。
2. 按项目说明启动本地引擎，首次运行会自动创建 SQLite 数据库文件及父目录，并设置受限权限。
3. 用绝对路径指定数据库位置（尤其走 MCP 接入时）：MCP 客户端的启动目录各不相同，相对路径会导致”昨天存的记忆今天找不到了”的灵异事件。
4. 在 Claude Code / Cursor 的 MCP 配置里加入 Mnemosyne 的 Server 配置，重启客户端后验证 memory_* 工具是否出现。
5. 存一条测试记忆再召回，确认读写链路通畅。

装完建议改的 3 个设置

1. 只读模式开关 —— 入口：启动参数/配置文件。体感差别：给”只许读不许写”的 Agent（如评审类 Agent）开只读后，再也不用担心它半夜改掉你的记忆库。
2. 破坏性删除操作的启用开关 —— 入口：启动参数。体感差别：默认建议关闭，记忆删了就真没了；需要定期清理时再临时打开，删完即关。
3. 数据库备份计划 —— 入口：不在软件里，在你的 cron / 计划任务里。体感差别：单个 SQLite 文件既是优点也是单点，设个每日自动拷贝，文件损坏时最多丢一天。

注意事项与常见问题

1. SQLite 是单机方案：跨主机共享、高并发写入的边界要结合文档确认，别把它当分布式数据库用。
2. 记忆质量取决于检索配置：项目展示的评测结果是在特定模型与提示词下测得的，换模型、换提示词效果会变，别直接当生产指标。
3. MCP 客户端权限有限：客户端不能自行切换工作区或提升信任级别，跨项目复用记忆时要手动规划好工作区划分。
4. 来源纠正是杀手锏也是坑：来源被纠正后，依赖旧来源的记忆会被”退休”——设计工作流时要预留人工复核环节，别让自动纠错悄悄改了关键事实。

适合谁 / 不适合谁

适合：给本地/单机 AI Agent 加长期记忆的开发者，特别是 TypeScript 技术栈、用 Claude Code / Cursor 的团队；需要”记忆带证据、可追溯、可纠错”的场景。不适合：需要多节点共享、托管运维、企业级 SLA 的团队；也不适合把记忆当缓存用的高频读写场景。

独家整理：它的”退休机制”为什么值得单独说

多数记忆系统只解决”存”和”查”，Mnemosyne 多做了一步”纠”：每条记忆都关联着它的来源证据和时间线，当来源被纠正（比如某条知识过时了），系统能找到所有依赖这条来源的记忆并将其”退休”——不再参与后续召回，但数据保留可审计。这对长期运行的 Agent 很关键：没有这套机制，Agent 会在几个月后变成一个”记得很多、但不知道哪些已经错了”的不可靠协作者。评估时重点看这一块是否符合你的纠错流程，这是它与普通向量记忆方案拉开差距的地方。

开源地址

前往 GitHub 项目页

GitHub 国内访问较慢，如打不开可多刷新几次

版本对比与推荐

版本推荐：推荐先用稳定版 Release 预构建，跑顺了再考虑源码运行。

安装步骤

1. 确认运行环境：按官网说明准备对应平台的 Node 运行环境，具体版本要求以官网为准。
2. 取包方式二选一：直接用 Release 预构建包最省事；要改源码或二次开发再走源码运行。
3. 接入 Agent：按官网说明把 MCP Server 接入你的 Agent 框架，先确认记忆读写接口能连通。
4. 先小规模验证：先用一个小记忆库试存一条事实、再召回一次，确认读写和纠错都正常后再正式用。

必改设置

1. 记忆库文件位置：把单个 SQLite 文件放到有定期备份的目录里，入口在启动配置中指定路径；丢了这个文件等于丢了全部记忆，体感差别就是能不能找回。
2. 召回条数上限：按官网说明设一个合理的召回上限，太大容易把上下文撑满，太小则 Agent 想不起关键事实。
3. 纠正与检查点策略（通用建议）：定期检查记忆里的错误条目并及时纠正，重要任务节点前先做一次检查点，出问题能回退而不是从头教起。

常见问题与注意事项

1. 只能单机用吗：它定位是本地优先的单机记忆系统，分布式集群或托管服务不在它的设计目标里，选型前先确认这一点。
2. 记忆存在哪里：所有记忆、来源证据和时间历史都存在单个 SQLite 文件里，备份这个文件就是备份全部记忆。
3. 接不进 Agent 怎么办：先看 MCP Server 的连通性与配置路径是否写对，接口细节以官网说明为准。

常见报错与排错

遇到问题时先按上面常见问题逐条排查，仍无法解决再对照官网说明确认版本与配置细节，以官网为准。

推广

关注「软件教程管家」

回复软件名即取即下：网盘下载链接 + 提取码，一步直达，不用再跳转。

相关推荐

开源项目WallpaperMachine 免费下载开发node-rs 免费下载｜Rust 原生绑定包集合开发Roundhouse 免费下载｜Ruby 静态分析开发Flatcar Container Linux 免费下载开发Nature Skills 免费下载开发bddisasm 免费下载｜轻量级 C 指令解码库