FindMCP Logo FindMCP.info
Basic Memory

Basic Memory

site icon
2025.04.18 524
Python知识管理AI协作Markdown工具本地存储内容生成开发效率
Basic Memory 是一个基于 Model Context Protocol (MCP) 的本地知识管理系统，允许用户通过与大型语言模型（如 Claude）的自然对话构建持久化的知识库。所有知识以 Markdown 文件的形式存储在本地，支持双向读写，既可以通过 LLM 操作，也可以直接通过文件编辑器查看和修改。
View on GitHub

Overview

基本能力

产品定位

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 工具（推荐安装方式）

安装教程

# 使用 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 引用实体

许可证

该项目遵循 AGPL-3.0 开源许可条款，请参阅 AGPL-3.0 了解完整条款。