Basic Memory

Basic Memory 是一个知识管理系统，允许您通过与大型语言模型（如 Claude）的自然对话来构建持久的知识库，同时将所有内容保存为本地 Markdown 文件。

安装

使用 uv 安装（推荐）

# 安装主程序
uv install basic-memory

# 配置 Claude 桌面版
# 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json
# 添加以下内容:
{
  "mcpServers": {
    "basic-memory": {
      "command": "uvx",
      "args": [
        "basic-memory",
        "mcp"
      ]
    }
  }
}

使用 Smithery 安装（自动配置）

npx -y @smithery/cli install @basicmachines-co/basic-memory --client claude

基本使用

在 Claude 桌面版中：

• 创建笔记：创建关于咖啡冲泡方法的笔记
• 读取笔记：我对倒注咖啡了解什么？
• 搜索信息：查找有关埃塞俄比亚豆的信息

您的知识库默认保存在 ~/basic-memory 目录。

CLI 工具

# 安装命令行工具
uv tool install basic-memory

# 创建新项目
basic-memory project add coffee ./examples/coffee

# 设置默认项目
basic-memory project default coffee

# 查看项目列表
basic-memory project list

工作原理

1. 与 Claude 正常聊天，分享信息（例如关于咖啡冲泡方法）
2. 请求 Claude 记录知识：让我们写一篇关于咖啡冲泡方法的笔记
3. Claude 会在您的本地目录创建结构化 Markdown 文件
4. 您可以在任何 Markdown 编辑器中查看或编辑这些文件（如 Obsidian）
5. 在后续对话中，Claude 可以访问和引用这些知识

Basic Memory 将信息组织为语义知识图谱，使 LLM 能够在对话中维持上下文感知，同时保持所有数据完全在您的控制之下。

---

详细文档：http://memory.basicmachines.co
网站：http://basicmachines.co