mcp-memory-libsql

基本能力

产品定位

mcp-memory-libsql 是一个高性能的持久化内存系统，专为模型上下文协议（MCP）设计，提供向量搜索和知识存储功能。

核心功能

• 🚀 使用 libSQL 进行高性能向量搜索
• 💾 持久化存储实体和关系
• 🔍 语义搜索能力
• 🔄 知识图谱管理
• 🌐 兼容本地和远程 libSQL 数据库
• 🔒 远程数据库的基于令牌的安全认证

适用场景

• 需要高性能向量搜索的应用
• 知识图谱管理和语义搜索
• 需要持久化存储实体和关系的场景

工具列表

• libSQL: 提供高性能的向量搜索和数据库管理能力

常见问题解答

• 如何配置本地和远程数据库？
• 本地 SQLite 数据库：LIBSQL_URL=file:/path/to/database.db
• 远程 libSQL 数据库：LIBSQL_URL=libsql://your-database.turso.io 和 LIBSQL_AUTH_TOKEN=your-auth-token
• WSL 环境下需要注意什么？
• 确保数据库路径使用 Linux 文件系统格式（如 /home/username/...）

使用教程

使用依赖

• 需要安装 Node.js 和 npm

安装教程

1. 添加以下配置到你的 Cline MCP 设置中：

{
    "mcpServers": {
        "mcp-memory-libsql": {
            "command": "npx",
            "args": ["-y", "mcp-memory-libsql"],
            "env": {
                "LIBSQL_URL": "file:/path/to/your/database.db"
            }
        }
    }
}

1. 对于 WSL 环境，参考 Getting MCP Server Working with Claude Desktop in WSL

调试方式

1. 确保数据库路径正确
2. 检查环境变量是否设置正确
3. 运行服务并检查日志输出

API

• 实体管理
• 创建/更新带嵌入的实体
• 删除实体
• 按相似性搜索实体
• 关系管理
• 创建实体间关系
• 删除关系
• 查询相关实体

架构

• 使用 libSQL 数据库，包含实体表和关系表
• 使用 libSQL 的内置向量操作实现向量搜索

开发

发布

1. 创建变更集：pnpm changeset
2. 版本更新：pnpm changeset version
3. 发布到 npm：pnpm release

许可证

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