Basic Memory - MCP服务，MCP服务器，MCP教程

基本能力

产品定位

Basic Memory 是一个本地优先的知识管理系统，旨在通过自然语言交互帮助用户构建、组织和检索结构化知识。

核心功能

• 本地存储：所有知识以 Markdown 文件形式存储在用户本地计算机上
• 双向交互：支持 LLM 和用户对同一知识库进行读写操作
• 结构化知识：通过 Markdown 文件中的特定格式（如 frontmatter、观察和关系）实现知识的结构化
• 知识图谱：自动构建本地知识图谱，支持语义导航和关联检索
• 实时同步：文件修改和知识图谱实时同步
• 多工具集成：支持 VS Code、Claude Desktop 等多种工具集成

适用场景

• 个人知识管理
• 项目文档整理
• 研究笔记构建
• 代码开发中的知识积累
• 与 AI 协作的知识共创

工具列表

1. write_note: 创建或更新笔记
2. read_note: 按标题或永久链接读取笔记
3. build_context: 通过 memory:// URL 导航知识图谱
4. search_notes: 在知识库中搜索
5. recent_activity: 查找最近更新的信息
6. canvas: 生成知识可视化

常见问题

• 如何配置 Claude Desktop 使用 Basic Memory？
• 如何管理多个项目？
• 如何从 OpenAI/Claude 项目导入数据？

使用教程

使用依赖

• Python 3.12+
• uv 工具（推荐安装方式）

安装教程

```bash

使用 uv 安装（推荐）

uv tool install basic-memory

或者通过 Smithery 安装

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

调试方式

1. 检查默认目录 ~/basic-memory 是否创建
2. 验证 Markdown 文件是否能正常生成
3. 测试与 Claude Desktop 的集成是否正常工作

技术实现

• 使用 Markdown 文件存储数据
• 使用 SQLite 数据库进行搜索和索引
• 实现 Model Context Protocol (MCP) 用于 AI 集成
• 支持 memory:// URL 引用实体