mcp-memory-libsql

一个由libSQL驱动的高性能持久内存系统，适用于模型上下文协议（MCP）。此服务器提供向量搜索功能，并使用libSQL作为后端存储来高效地存储知识。

<a href="https://glama.ai/mcp/servers/22lg4lq768"> <img width="380" height="200" src="https://gips0.baidu.com/it/u=20552601,2400863736&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Glama 徽章" /> </a>

功能

• 🚀 使用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配置

有关如何在Claude Desktop中使用WSL设置此服务器的详细指南，请参阅 在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），发布需要手动完成：

1. 创建更改集（记录您的更改）：

pnpm changeset

2. 版本化包（更新版本和CHANGELOG）：

pnpm changeset version

3. 发布到npm（将提示输入2FA代码）：

pnpm release

贡献

欢迎贡献！请在提交拉取请求之前阅读我们的贡献指南。

许可证

MIT许可证 - 详情见LICENSE文件。

致谢

• 基于模型上下文协议
• 由libSQL驱动 </中文翻译>