smithery badge

🚀 Basic Memory 云端版现已上线！

跨设备多平台支持：您的知识图谱现在可在桌面端、网页端和移动端无缝同步，兼容所有AI工具（Claude、ChatGPT、Gemini、Claude Code和Codex）
早鸟优惠：早期用户永久享受25%折扣开源项目持续更新，云端版让知识管理无处不在

立即注册享受7天免费试用

Basic Memory

Basic Memory 让您通过与Claude等大语言模型(LLM)的自然对话建立持久知识库，所有内容都以Markdown文件形式保存在本地。它采用模型上下文协议(MCP)，使任何兼容的LLM都能读写您的本地知识库。

官网: https://basicmachines.co
文档: https://memory.basicmachines.co

随时接续未完成对话

AI助手可以从本地文件加载上下文开启新对话
笔记实时以Markdown格式保存到本地
无需项目知识或特殊提示词

https://github.com/user-attachments/assets/a55d8238-8dd0-454a-be4c-8860dbbd0ddc

快速开始

# 推荐使用uv安装
uv tool install basic-memory

# 配置Claude Desktop（编辑~/Library/Application Support/Claude/claude_desktop_config.json）
# 添加以下配置：
{
  "mcpServers": {
    "basic-memory": {
      "command": "uvx",
      "args": [
        "basic-memory",
        "mcp"
      ]
    }
  }
}
# 现在在Claude Desktop中您可以：
# - 通过"创建关于咖啡冲泡方法的笔记"写笔记
# - 通过"我对滴滤咖啡了解多少？"读笔记
# - 通过"查找关于埃塞俄比亚咖啡豆的信息"进行搜索

默认存储位置为~/basic-memory目录，您可在此查看共享上下文。

通过Smithery安装替代方案

使用Smithery自动配置Basic Memory与Claude Desktop的集成：

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

这种方式无需手动编辑Claude Desktop配置文件。Smithery服务器托管MCP服务组件，而您的数据仍以Markdown文件形式存储在本地。

Glama.ai集成

为什么选择Basic Memory？

大多数LLM交互都是临时的——您提出问题、获得答案，然后一切都被遗忘。每次对话都重新开始，缺乏之前对话的上下文和知识积累。现有解决方案存在局限：

聊天记录仅保存对话而非结构化知识
RAG系统可查询文档但不允许LLM回写
向量数据库需要复杂设置且通常部署在云端
知识图谱通常需要专业工具维护

Basic Memory通过简单方案解决这些问题：使用人类和LLM都能读写的结构化Markdown文件。核心优势包括：

本地优先：所有知识存储在您控制的文件中
双向交互：您和LLM都能读写相同文件
简洁结构化：采用熟悉的Markdown语义格式
可遍历知识图谱：LLM能跟踪主题间链接
标准格式：兼容Obsidian等现有编辑器
轻量架构：仅需本地文件和SQLite数据库索引

使用Basic Memory，您可以：

开展基于已有知识的连续对话
在自然对话中创建结构化笔记
与"记得"之前讨论内容的LLM对话
语义化导航知识图谱
保持所有数据本地可控
使用Obsidian等工具查看编辑笔记
建立持续增长的个人知识库
通过双向同步实现云端备份
通过订阅验证管理云端项目
直接挂载访问云存储

实际应用场景

假设您正在研究咖啡冲泡方法并希望记录知识：

开始常规对话：

我最近尝试了不同咖啡冲泡方法，主要发现：
- 滴滤法比法压壶更能突出风味层次
- 水温至关重要 - 约205°F效果最佳
- 现磨咖啡豆带来显著差异

...继续对话

让LLM帮助结构化知识：

"我们写一份关于咖啡冲泡方法的笔记吧"

LLM会在您系统中创建Markdown文件（可立即在Obsidian或编辑器中查看）：

---
title: 咖啡冲泡方法
permalink: coffee-brewing-methods
tags:
- 咖啡
- 冲泡
---

# 咖啡冲泡方法

## 观察记录

- [方法] 滴滤法能提供更清晰的风味轮廓
- [技巧] 96°C水温可最佳萃取化合物
- [原则] 现磨咖啡豆保留芳香物质

## 关联关系

- 关联 [[咖啡豆产地]]
- 需要 [[研磨技巧]]
- 影响 [[风味萃取]]

文件实时保存在项目目录（默认~/$HOME/basic-memory）

运行basic-memory sync --watch可启用实时同步

在对话中引用主题：

查看`coffee-brewing-methods`获取滴滤咖啡背景

LLM现在可以从知识图谱构建丰富上下文，例如：

追踪'关联 [[咖啡豆产地]]'关系：
- 发现埃塞俄比亚耶加雪菲信息
- 哥伦比亚豆的坚果风味笔记
- 海拔对咖啡豆特性的影响

追踪'需要 [[研磨技巧]]'关系：
- 磨盘式与刀片式磨豆机对比
- 不同冲泡法的研磨度建议
- 颗粒均匀度对萃取的影响

技术实现

底层机制上，Basic Memory：

使用Markdown文件存储所有内容
通过SQLite数据库实现搜索索引
从简单Markdown模式提取语义：
- 文件转为实体对象
- 每个实体可包含观察项(事实)
- 关系连接实体形成知识图谱
维护基于文件的本地知识图谱
提供文件与图谱的双向同步
实现MCP协议支持AI集成
提供AI遍历操作图谱的工具
使用memory:// URL实现跨工具引用

文件格式为增强型Markdown：

前置元数据

title: <实体标题>
type: <实体类型> (如笔记)
permalink: <URI标识>

- <可选元数据> (如标签)

观察项格式

- [类别] 内容 #标签 (可选上下文)

示例：

- [方法] 滴滤法比法压壶更突出花香
- [贴士] 滴滤适用中细研磨度 #冲泡
- [偏好] 埃塞俄比亚豆具有明亮果香

关系定义

- 关系类型 [[维基链接]] (可选上下文)

示例：

- 搭配 [[巧克力甜点]]
- 原产于 [[埃塞俄比亚]]
- 区别于 [[茶饮冲泡]]

与 VS Code 配合使用

在 VS Code 的用户设置 (JSON) 文件中添加以下 JSON 代码块。您可以通过按下 Ctrl + Shift + P 并输入 Preferences: Open User Settings (JSON) 来完成此操作。

{
  "mcp": {
    "servers": {
      "basic-memory": {
        "command": "uvx",
        "args": ["basic-memory", "mcp"]
      }
    }
  }
}

您也可以选择将其添加到工作区的 .vscode/mcp.json 文件中。这样可以让您与他人共享配置。

{
  "servers": {
    "basic-memory": {
      "command": "uvx",
      "args": ["basic-memory", "mcp"]
    }
  }
}

您可以在 VS Code 中使用 Basic Memory 来轻松检索和存储编码时的信息。

与 Claude Desktop 配合使用

Basic Memory 使用 MCP（模型上下文协议）构建，可与 Claude 桌面应用程序（https://claude.ai/）配合使用：

配置 Claude Desktop 使用 Basic Memory：

编辑您的 MCP 配置文件（在 OS X 上通常位于 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "basic-memory": {
      "command": "uvx",
      "args": [
        "basic-memory",
        "mcp"
      ]
    }
  }
}

如果您想使用特定项目（参见下面的多项目），请更新您的 Claude Desktop 配置：

{
  "mcpServers": {
    "basic-memory": {
      "command": "uvx",
      "args": [
        "basic-memory",
        "mcp",
        "--project",
        "your-project-name"
      ]
    }
  }
}

同步您的知识：

# 一次性同步本地知识更新
basic-memory sync

# 运行实时同步进程（推荐）
basic-memory sync --watch

云功能（可选，需要订阅）：

# 与云端认证
basic-memory cloud login

# 与云端双向同步
basic-memory cloud sync

# 验证云端完整性
basic-memory cloud check

# 挂载云存储
basic-memory cloud mount

在 Claude Desktop 中，LLM 现在可以使用这些工具：

内容管理：

write_note(title, content, folder, tags) - 创建或更新笔记
read_note(identifier, page, page_size) - 通过标题或永久链接读取笔记
read_content(path) - 读取原始文件内容（文本、图像、二进制文件）
view_note(identifier) - 以格式化工件查看笔记
edit_note(identifier, operation, content) - 增量编辑笔记
move_note(identifier, destination_path) - 移动笔记并保持数据库一致性
delete_note(identifier) - 从知识库中删除笔记

知识图谱导航：

build_context(url, depth, timeframe) - 通过 memory:// URL 导航知识图谱
recent_activity(type, depth, timeframe) - 查找最近更新的信息
list_directory(dir_name, depth) - 浏览目录内容并进行筛选

搜索与发现：

search(query, page, page_size) - 在您的知识库中搜索

项目管理：

list_memory_projects() - 列出所有可用项目
create_memory_project(project_name, project_path) - 创建新项目
get_current_project() - 显示当前项目统计信息
sync_status() - 检查同步状态

可视化：

canvas(nodes, edges, title, folder) - 生成知识可视化

可以尝试的示例提示：

"创建一个关于我们项目架构决策的笔记"
"在我的笔记中查找关于 JWT 认证的信息"
"创建一个项目组件的画布可视化"
"阅读我关于认证系统的笔记"
"我过去一周在做什么？"

许可证

AGPL-3.0

欢迎贡献。有关本地设置项目和提交 PR 的信息，请参阅贡献指南。

星标历史

由 Basic Machines 用 ♥️ 构建