mcp-memory-libsql

一个高性能、持久内存系统，用于模型上下文协议（MCP），由libSQL提供支持，并针对LLM上下文效率进行了优化的文本搜索。

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

特性

• 🚀 高性能文本搜索并按相关性排序
• 💾 实体和关系的持久存储
• 🔍 支持模糊匹配的灵活文本搜索
• 🎯 针对LLM效率优化的上下文
• 🔄 知识图谱管理
• 🌐 兼容本地和远程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设置此服务器的详细指南，请参阅 在WSL中让MCP服务器与Claude Desktop一起工作。

在你的Claude Desktop配置中为WSL环境添加以下内容：

{
	"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数据库，具有以下模式：

• 实体表：存储带有时间戳的实体信息
• 观察表：存储实体观察
• 关系表：存储实体之间的关系
• 文本搜索并按相关性排序（名称 > 类型 > 观察）

开发

发布

由于npm 2FA的要求，发布需要手动进行：

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

pnpm changeset

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

pnpm changeset version

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

pnpm release

贡献

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

许可证

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

致谢

• 基于模型上下文协议
• 由libSQL提供支持