MCP-LibSQL内存搜索服务
# 翻译 一个高性能的MCP服务器，利用libSQL实现持久内存和向量搜索功能，能够高效地进行实体管理和语义知识存储。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"mcp-memory-libsql": {
"args": [
"-y",
"mcp-memory-libsql"
],
"command": "npx",
"env": {
"LIBSQL_URL": "file:/path/to/your/database.db"
}
}
}
}可用工具 （6 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
create_entities 1 个参数 需填 1 项
Create new entities with observations and optional embeddings
必填参数：entities
search_nodes 1 个参数 需填 1 项
Search for entities and their relations using text or vector similarity
必填参数：query
read_graph
Get recent entities and their relations
该工具无需必填参数，直接调用即可
create_relations 1 个参数 需填 1 项
Create relations between entities
必填参数：relations
delete_entity 1 个参数 需填 1 项
Delete an entity and all its associated data (observations and relations)
必填参数：name
delete_relation 3 个参数 需填 3 项
Delete a specific relation between entities
必填参数：source、target、type
服务介绍
mcp-memory-libsql
一个高性能、持久化的内存系统，用于支持 Model Context Protocol (MCP)，由 libSQL 提供动力。该服务器提供了向量搜索功能，并使用 libSQL 作为后端存储来实现高效的知识存储。
特性
- 🚀 使用 libSQL 进行高性能向量搜索
- 💾 持久化存储实体和关系
- 🔍 语义搜索功能
- 🔄 知识图谱管理
- 🌐 兼容本地和远程的 libSQL 数据库
- 🔒 对于远程数据库的安全基于令牌的身份验证
配置
此服务器设计为作为 MCP 配置的一部分使用。以下是不同环境下的示例：
Cline 配置
将以下内容添加到您的 Cline MCP 设置中：
{
"mcpServers": {
"mcp-memory-libsql": {
"command": "npx",
"args": ["-y", "mcp-memory-libsql"],
"env": {
"LIBSQL_URL": "file:/path/to/your/database.db"
}
}
}
}
Claude Desktop 与 WSL 配置
有关在 WSL 中使用 Claude Desktop 设置此服务器的详细指南，请参阅在 WSL 中使 MCP 服务器与 Claude Desktop 协同工作。
对于 WSL 环境，将以下内容添加到您的 Claude Desktop 配置中：
{
"mcpServers": {
"mcp-memory-libsql": {
"command": "wsl.exe",
"args": [
"bash",
"-c",
"source ~/.nvm/nvm.sh && LIBSQL_URL=file:/path/to/database.db /home/username/.nvm/versions/node/v20.12.1/bin/npx mcp-memory-libsql"
]
}
}
}
数据库配置
该服务器通过 LIBSQL_URL 环境变量支持本地 SQLite 和远程 libSQL 数据库：
对于本地 SQLite 数据库：
{
"env": {
"LIBSQL_URL": "file:/path/to/database.db"
}
}
对于远程 libSQL 数据库（例如 Turso）：
{
"env": {
"LIBSQL_URL": "libsql://your-database.turso.io",
"LIBSQL_AUTH_TOKEN": "your-auth-token"
}
}
注意：当使用 WSL 时，请确保数据库路径使用 Linux 文件系统格式（例如 /home/username/...），而不是 Windows 格式。
默认情况下，如果没有提供 URL，它将在当前目录下使用 file:/memory-tool.db。
API
该服务器实现了标准的 MCP 内存接口，并增加了向量搜索功能：
- 实体管理
- 创建/更新带有嵌入的实体
- 删除实体
- 按相似度搜索实体
- 关系管理
- 在实体间创建关系
- 删除关系
- 查询相关实体
架构
该服务器使用了具有以下模式的 libSQL 数据库：
- 实体表：存储实体信息和嵌入
- 关系表：存储实体之间的关系
- 利用 libSQL 的内置向量操作实现向量搜索功能
开发
发布
由于 npm 要求双因素认证 (2FA)，发布需要手动完成：
- 创建更改集（记录您的更改）：
pnpm changeset
- 对包进行版本控制（更新版本和 CHANGELOG）：
pnpm changeset version
- 发布到 npm（将提示输入 2FA 代码）：
pnpm release
贡献
欢迎贡献！请在提交拉取请求前阅读我们的贡献指南。
许可证
MIT 许可证 - 详情请参见 LICENSE 文件。
致谢
- 基于 Model Context Protocol
- 由 libSQL 提供支持
