关键词

知识管理本地优先LLM上下文服务个人知识库

项目简介

Basic Memory是一个本地优先的知识管理工具，旨在帮助用户构建持久化的个人知识库。它使用Markdown文件存储知识，并实现了模型上下文协议（MCP）服务器，允许兼容MCP协议的LLM客户端（如Claude Desktop）读取和写入本地知识库，从而实现LLM与本地知识的自然语言交互，构建基于本地文件的个人知识图谱。

主要功能点

  • 本地优先的知识存储: 所有知识都保存在用户本地电脑的Markdown文件中，用户完全掌控数据。
  • 双向知识交互: 支持LLM和用户双向读写相同的Markdown文件，实现知识的自然积累和演进。
  • 结构化Markdown: 使用简单的Markdown格式和语义模式来组织知识，方便人机阅读和编辑。
  • 知识图谱遍历: LLM可以语义化地遍历知识图谱，发现和利用知识之间的关联。
  • 标准格式兼容: 知识库使用Markdown等开放格式，兼容Obsidian等现有编辑器。
  • 轻量级基础设施: 基于本地文件和SQLite数据库，无需复杂的云端或服务器部署。
  • MCP服务器: 实现了MCP协议，可以与兼容MCP协议的LLM客户端进行无缝集成。

安装步骤

  1. 安装 Basic Memory: 推荐使用 'uv' 工具安装 Basic Memory：

    uv tool install basic-memory

  2. 配置 Claude Desktop (或其他 MCP 客户端): 编辑 Claude Desktop 的配置文件 'claude_desktop_config.json' (通常位于 '~/Library/Application Support/Claude/' 或 '~/AppData/Roaming/Claude/')，在 'mcpServers' 中添加 'basic-memory' 服务器配置：

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

服务器配置

Basic Memory 作为 MCP 服务器，主要通过命令行参数进行配置。在 'claude_desktop_config.json' 或其他 MCP 客户端的配置中，你需要指定服务器的启动命令 (command) 和参数 (args)。

以下是 Basic Memory MCP 服务器的配置信息：

{
  "mcpServers": {
    "basic-memory": {
      "command": "uvx",  // MCP服务器启动命令，这里使用 uvx 运行 basic-memory
      "args": [
        "basic-memory", // 执行 basic-memory 工具
        "mcp"         // 运行 mcp 服务器模式
      ]
      // "name": "basic-memory",  // (可选) 服务器名称，用于在客户端中标识
      // "description": "My Basic Memory Server", // (可选) 服务器描述
    }
  }
}
  • 'command': MCP 服务器的启动命令。这里配置为 'uvx'，它会调用使用 'uv tool install' 安装的 'basic-memory' 工具。
  • 'args': 传递给启动命令的参数。
    • '"basic-memory"': 指定要运行的工具名称。
    • '"mcp"': 指定 'basic-memory' 工具以 MCP 服务器模式运行。

基本使用方法

  1. 启动 Basic Memory MCP 服务器: Basic Memory MCP 服务器会在 Claude Desktop (或其他 MCP 客户端) 尝试连接时自动启动。你也可以手动运行 'basic-memory mcp' 命令来启动服务器。

  2. 在 Claude Desktop 中与 Basic Memory 交互: 配置完成后，在 Claude Desktop 中即可使用以下示例提示与 Basic Memory 知识库进行交互：

    • 创建笔记: 'Create a note about coffee brewing methods'
    • 读取笔记: 'What do I know about pour over coffee?'
    • 搜索信息: 'Find information about Ethiopian beans'
    • 创建画布可视化: 'Create a canvas visualization of my project components'

  3. 查看和编辑知识库: Basic Memory 的知识库以 Markdown 文件形式存储在本地 '~/basic-memory' 目录下 (默认位置)。你可以使用任何 Markdown 编辑器 (如 Obsidian) 查看和编辑这些文件。

  4. 同步知识库:

    • 运行 'basic-memory sync' 命令进行一次性同步，将本地 Markdown 文件的更改同步到知识库。
    • 运行 'basic-memory sync --watch' 命令启动实时同步进程，监控文件更改并自动同步。

更多详细使用方法，请参考 Basic Memory 官方文档。

信息

分类

数据库与文件

访问项目