# Basic Memory - MCP原生的AI知识图谱记忆系统

> Markdown文件做记忆载体，AI和人类双向读写，知识图谱+语义搜索，Claude/Codex/Cursor/Hermes全平台支持

## Basic Memory 是什么

Basic Memory 是一个 **MCP 原生的 AI 知识图谱记忆系统**，让 AI 永远不会忘记。你的知识以 Markdown 文件存在磁盘上，AI 和人类都能读写搜索。支持 Claude、Codex、Cursor、ChatGPT 等所有 MCP 兼容客户端。

## 核心特性

**本地优先**：纯文本 Markdown 存在你磁盘上，永远属于你，可离线、可断网使用。

**双向读写**：AI 和人类写同一批文件，同步机制保持一致。不是单向注入，而是真正的协作知识库。

**真实知识图谱**：通过 Observations（观察）和 Wikilinks（内部链接）构建知识图谱，信息自动积累上下文。

**语义搜索**：按含义而非关键词查找笔记，不限于精确匹配。

**MCP 原生**：作为 MCP Server 运行，所有支持 MCP 的 AI 客户端直接接入，无需额外适配。

**渐进式工具发现**：每个工具都标注了行为提示（只读/破坏性/幂等），Agent 能自动选择正确工具，不浪费上下文。

## 客户端支持

| 客户端 | 传输方式 |
|--------|---------|
| Claude Desktop | stdio/https |
| Claude Code | stdio/https + 插件（会话简报/压缩检查点） |
| Codex CLI | stdio/https |
| Cursor | stdio/https |
| VS Code | stdio/https |
| ChatGPT | https（Custom GPT） |
| Obsidian | 直接读写同一份 Markdown |
| Hermes Agent | 官方插件 `hermes plugins install basicmachines-co/basic-memory` |
| OpenClaw | 官方插件 |

## 安装

```bash
# 本地安装（免费，AGPL-3.0）
uv tool install basic-memory

# Claude Code 一行接入
claude mcp add basic-memory -- uvx basic-memory mcp

# Hermes Agent 接入
hermes plugins install basicmachines-co/basic-memory --path integrations/hermes
```

默认笔记存储在 `~/basic-memory`，Obsidian 可直接打开同一目录。

## 云服务（可选）

$15/月终身锁定价，7天免费试用。跨设备同步、快照备份、Web/移动端访问。数据始终可导出为本地 Markdown，无锁定。

## 技术栈

Python 3.12+，本地使用 SQLite，开源协议 AGPL-3.0。

---

**分类**：软件
**标签**：知识 · AI · MCP
**作者**：Xiao.Xi
**链接**：https://octohz.com/p/1846