适合谁
- 注重隐私、希望数据本地保存的个人开发者。
- 需要 AI 辅助管理大量笔记和知识库的研究人员。
- 使用 Obsidian 等 Markdown 编辑器的用户。
B
72FMRS · B
Basic Memory 提供了本地优先的双向知识管理能力，与多种 AI 客户端无缝集成。其 Markdown 格式和知识图谱设计使其易于理解和扩展。然而，云服务需付费，且本地模式需要 Python 环境。整体上，它是提升 AI 记忆能力的强大工具，尤其适合重视隐私的开发者。
Basic Memory 是一个本地优先的知识管理服务器，通过 Markdown 文件实现人类与 AI 之间的双向同步。它支持知识图谱、语义搜索，并与 Claude、Codex、Cursor 等 MCP 客户端集成，让你和 AI 能共同读写、搜索和管理知识。
工具能力
write_note
创建或覆盖笔记。
read_note
读取笔记内容。
edit_note
编辑笔记，支持追加和前置内容。
move_note
移动笔记到新位置。
delete_note
删除笔记。
read_content
读取任意文件内容。
view_note
查看笔记详情。
search_notes
搜索笔记，支持语义和混合搜索。
recent_activity
获取最近的活动记录。
list_directory
列出目录内容。
build_context
构建知识图谱上下文，通过 memory:// URLs 导航。
list_memory_projects
列出所有记忆项目。
list_workspaces
列出所有工作区。
create_memory_project
创建新的记忆项目。
delete_project
删除记忆项目。
schema_infer
推断知识库的结构模式。
schema_validate
验证知识库的结构模式。
schema_diff
比较知识库的结构差异。
search
兼容 OpenAI 的搜索工具。
fetch
兼容 OpenAI 的获取工具。
basic_memory_diagnostics
运行诊断检查。
安装接入
通过 uv 安装 basic-memory，然后在客户端配置 MCP 服务器。例如在 Claude Desktop 中添加：
{
"mcpServers": {
"basic-memory": {
"command": "uvx",
"args": ["basic-memory", "mcp"]
}
}
}
claude_desktop_config.json
{
"mcpServers": {
"basic-memory": {
"command": "uvx",
"args": [
"basic-memory",
"mcp"
]
}
}
}
选型与风险
不适合谁
- 需要云端同步和移动访问的用户（除非使用付费云服务）。
- 希望零代码配置的极简用户。
- 需要大规模向量数据库和复杂检索的场景（仅本地 SQLite 可能不够）。
所需权限
- 读取和写入本地文件系统（默认在 ~/basic-memory）。
- 执行文件和目录操作（创建、编辑、删除）。
- 访问本地 SQLite 数据库（或 Postgres/Milvus，如果配置）。
风险与副作用
- 工具具有写操作，可能意外修改或删除笔记。
- 编辑操作可能覆盖现有内容，尽管有保护机制。
- 语义搜索和重排序功能可能需要下载模型，增加延迟。
- 本地数据备份由用户自行负责。
常见排障
- 确保已安装 uv 和 Python 3.12+，并检查 MCP 服务器是否成功启动。
- 可通过 `basic-memory status` 进行诊断，并查看日志文件 `~/.basic-memory/basic-memory.log` 获取错误信息。
- 如果搜索无结果，检查语义搜索是否启用。
使用场景
让 AI 记住你的项目偏好，无需重复解释。
跨会话持续记录和检索知识。
与团队共享一个知识库，供 AI 和人类共同编辑。
支持客户端
Claude Desktop完整支持
Claude Code完整支持
Codex CLI完整支持
Cursor完整支持
VS Code完整支持
ChatGPT完整支持
Obsidian完整支持