mcp-memory-libsql

一个高性能、持久化的内存系统，用于模型上下文协议 (MCP)，由 libSQL 驱动。该服务器提供向量搜索功能，并使用 libSQL 作为后端存储，实现高效的知识存储。

<a href="https://glama.ai/mcp/servers/22lg4lq768"> <img width="380" height="200" src="https://glama.ai/mcp/servers/22lg4lq768/badge" alt="Glama badge" /> </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 with WSL 配置

有关在 WSL 中设置此服务器与 Claude Desktop 一起使用的详细指南，请参阅 Getting MCP Server Working with Claude Desktop in WSL。

将其添加到 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 数据库：

• Entities 表：存储实体信息和嵌入
• Relations 表：存储实体之间的关系
• 使用 libSQL 的内置向量操作实现的向量搜索功能

开发

发布

由于 npm 2FA 要求，发布需要手动完成：

1. 创建一个 changeset（记录您的更改）：

pnpm changeset

2. 对包进行版本控制（更新版本和 CHANGELOG）：

pnpm changeset version

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

pnpm release

贡献

欢迎贡献！请在提交 pull request 之前阅读我们的贡献指南。

许可证

MIT 许可证 - 有关详细信息，请参阅 LICENSE 文件。

致谢

• 构建于 模型上下文协议 之上
• 由 libSQL 驱动