Basic Memory：人和智能体共写一套 Markdown 笔记
本地优先的记忆服务器。记忆就是磁盘上的 Markdown 文件，人和智能体都能读写，带维基链接图谱和语义搜索，可配合 Obsidian 使用。
项目与安装文档
查看项目https://github.com/basicmachines-co/basic-memory
很多记忆服务器把内容存进数据库，人看不到、也改不了，记错了只能让模型自己删。Basic Memory 的思路相反：每条记忆都是磁盘上的一个 Markdown 文件，智能体写的笔记你能直接用编辑器或 Obsidian 打开修改，你写的笔记智能体也能搜到。笔记里的观察条目和 [[维基链接]] 会被解析成知识图谱，供智能体顺着关系找上下文。
能做什么
- 读写笔记：
write_note、read_note、edit_note、move_note、delete_note，其中write_note会防止误覆盖已有文件。 - 搜索和导航：
search_notes支持语义搜索和混合检索，可选交叉编码器重排序；build_context沿memory://地址遍历关联笔记；recent_activity看最近改了什么。 - 多项目：一个安装可管理多个记忆项目，按工作或个人分开。
- 工具注解：每个工具都标了只读、破坏性、幂等等 MCP 提示，智能体能按需挑工具。
适合谁
- 已经用 Obsidian 或纯文本记笔记、希望 Claude 和 Codex 能读到并补充这些笔记的人。
- 跨多个项目工作、不想每次开会话都重新交代背景的开发者和顾问。
接入方式
本地版需要 Python 和 uv。--prerelease=allow 不能省，当前版本依赖 FastMCP 的预发布版：
uv tool install basic-memory --prerelease=allow
claude mcp add basic-memory -- uvx --prerelease=allow basic-memory mcp
Claude Desktop、Codex、Cursor、VS Code 的配置写法见 README 对应小节。
编辑点评
截至 2026-10-06 约 4100 star。它和官方 Memory 服务器、Hindsight 解决的是同一个问题，但把“人能看懂、能改”放在第一位：数据是纯文本，用 Git 或 Syncthing 就能同步和备份，换工具也带得走。这对需要审查智能体到底记了什么的人很重要。要注意三点：第一，智能体对笔记有删除和移动权限；第二，README 开头大段是云版推广（每月 15 美元），本地版免费，功能相同但跨设备同步要自己解决；第三，许可证是 AGPL-3.0，想把它改造后作为网络服务提供给他人，需要按条款开源。