使用说明

项目简介

LibSQL Memory 是一个基于 Model Context Protocol (MCP) 构建的服务器，它使用轻量级数据库 LibSQL 作为后端，为大型语言模型 (LLM) 应用提供持久化的知识存储和向量搜索功能。作为一个 MCP 服务器，LibSQL Memory 能够以标准化的方式与支持 MCP 协议的 LLM 客户端（如 Cline, Claude Desktop）进行交互，扩展 LLM 的上下文处理能力。

主要功能点

高性能向量搜索：利用 LibSQL 数据库的向量扩展，实现快速的语义搜索和相似度匹配。
持久化知识存储：使用 LibSQL 数据库持久化存储实体和关系，保证数据在服务器重启后不会丢失。
实体和关系管理：支持创建、更新、删除实体，以及创建实体之间的关系，构建知识图谱。
灵活的数据库配置：支持本地 SQLite 数据库和远程 Turso 数据库，可通过环境变量 'LIBSQL_URL' 灵活配置。
工具化接口：通过 MCP 协议提供标准化的工具接口，方便 LLM 客户端调用和集成。

安装步骤

安装 Node.js 和 npm：确保你的环境中已安装 Node.js 和 npm (Node 包管理器)。
全局安装 mcp-memory-libsql：打开终端，运行以下命令全局安装 LibSQL Memory MCP 服务器：
```
npm install -g mcp-memory-libsql
```

服务器配置

MCP 服务器需要配置在 MCP 客户端中才能使用。以下是 MCP 客户端需要配置的服务器信息（JSON 格式），以 Cline 为例：

{
  "mcpServers": {
    "mcp-memory-libsql": {
      "command": "npx",  // 启动服务器的命令，这里使用 npx 执行
      "args": ["-y", "mcp-memory-libsql"], // 传递给命令的参数，-y 表示自动确认
      "env": {
        "LIBSQL_URL": "file:/path/to/your/database.db" // 数据库连接 URL，这里配置为本地文件数据库，请替换为你的数据库文件路径
      }
    }
  }
}

配置参数说明:

'server name': 服务器名称，例如 "mcp-memory-libsql"，用于在客户端中标识和引用该服务器。
'command': 启动 MCP 服务器的命令。通常是可执行文件的路径或脚本命令。
'args': 传递给启动命令的参数，以数组形式提供。
'env': 设置服务器运行时的环境变量。例如，'LIBSQL_URL' 用于配置 LibSQL 数据库的连接地址。

数据库配置说明:

本地 SQLite 数据库: 将 'LIBSQL_URL' 设置为 'file:/path/to/your/database.db'，例如 'file:./memory.db'，会在指定路径创建或使用本地 SQLite 数据库文件。
远程 Turso 数据库: 如果使用 Turso 远程数据库，需要设置 'LIBSQL_URL' 为 'libsql://your-database.turso.io'，并配置 'LIBSQL_AUTH_TOKEN' 为你的 Turso 数据库的授权令牌。

基本使用方法

启动 MCP 服务器：在配置好客户端后，当客户端需要使用 MCP 服务器提供的功能时，会自动启动 LibSQL Memory 服务器。
通过 MCP 客户端与服务器交互：
- 客户端会通过 MCP 协议与 LibSQL Memory 服务器进行通信，调用服务器提供的工具 (Tools)。
- 服务器提供的工具主要用于管理实体 (Entities) 和关系 (Relations)，例如：
  - 'create_entities': 创建或更新实体，可以包含实体的名称、类型、观测信息和向量嵌入。
  - 'search_nodes': 根据文本或向量查询搜索实体及其关系。
  - 'read_graph': 获取最近的实体及其关系，构建知识图谱。
  - 'create_relations': 创建实体之间的关系。
  - 'delete_entity': 删除实体及其相关数据。
  - 'delete_relation': 删除实体之间的特定关系。
利用服务器功能扩展 LLM 上下文：客户端可以调用这些工具，将 LibSQL Memory 服务器作为 LLM 的外部知识库，增强 LLM 的记忆能力和知识检索能力。

更多详细的使用方法和 API 文档，请参考项目仓库的 README 文件和相关文档。

关键词