basicmachines-co/basic-memory

这是什么？

核心功能

• 01以纯 Markdown 文件存储知识，支持 wikilink 和 frontmatter。
• 02兼容所有 MCP 客户端，包括 Claude、Codex、Cursor 和 VS Code。
• 03支持关键词、语义向量及混合搜索。
• 04可选启用 cross-encoder 对向量和混合搜索结果重排序。
• 05提供 CLI，用于项目管理、一致性检查、导入和工具调用。
• 06默认本地运行于 SQLite，也可切换到 Postgres。

适用场景

• 在多次 AI 对话之间保留项目架构决策和上下文。
• 搭建个人知识库，让你和 AI 助手共同编辑。
• 把以往的 Claude 或 ChatGPT 对话导入为可搜索的笔记。
• 在 Obsidian 中编辑同时由 AI 维护的笔记。

快速上手

1. 1

   使用 uv 安装 Basic Memory

   uv tool install basic-memory --prerelease=allow
2. 2

   在 AI 客户端配置中添加 Basic Memory 服务器（以 Claude Desktop 为例）

3. 3

   重启 AI 客户端并开始使用

使用前须知

• !本地安装需要通过 uv 管理 Python 环境。
• !采用 AGPL-3.0 许可证，这是一种 copyleft 许可证，若将修改后的版本作为网络服务提供，需要公开源代码。
• !依赖 FastMCP 预发布版本，因此必须加上 --prerelease=allow 参数，否则会安装旧版本。

收录于专题

标签

常见问题

basic-memory 是什么？

本地优先的记忆层，让 Claude、Cursor 等 AI 助手通过 MCP 读写你的 Markdown 笔记。 Basic Memory 为 AI 助手提供持久记忆。知识以 Markdown 文件的形式保存在本地磁盘上，每个笔记是一个实体，包含带分类的观察条目和指向其他笔记的 wikilink 关系。你和 AI 客户端读写的是同一批文件，在 Obsidian 或编辑器里的修改，助手也能看到。

basic-memory 可以免费使用吗？用的什么许可证？

basic-memory 以 AGPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。

basic-memory 还在维护吗？

活跃维护中。basic-memory 最近一次提交是在 2026年11月6日。

basic-memory 适合用来做什么？

在多次 AI 对话之间保留项目架构决策和上下文。 搭建个人知识库，让你和 AI 助手共同编辑。 把以往的 Claude 或 ChatGPT 对话导入为可搜索的笔记。 在 Obsidian 中编辑同时由 AI 维护的笔记。

basic-memory 怎么安装和运行？

使用 uv 安装 Basic Memory: uv tool install basic-memory --prerelease=allow 在 AI 客户端配置中添加 Basic Memory 服务器（以 Claude Desktop 为例） 重启 AI 客户端并开始使用

在哪里获取 basic-memory？

源代码和安装说明在 GitHub 上：https://github.com/basicmachines-co/basic-memory