向量搜索数据库

一个基于libSQL的高性能持久化内存系统,提供向量搜索和知识图谱管理功能,适用于本地和远程数据库环境。

  • by joleyline
  • TypeScript
  • 本地部署
  • 24 星标
  • 更新于
在 GitHub 查看 joleyline/mcp-memory-libsql

使用说明

mcp内存libsql

用于模型上下文的高性能持久存储系统 由libSQL支持的协议(MCP)。此服务器提供矢量搜索 使用libSQL作为 支持商店。

特性

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

配置

此服务器旨在用作MCP配置的一部分。 以下是不同环境的示例:

临床配置

将此添加到您的Cline MCP设置中:

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

带WSL配置的Claude桌面

有关使用Claude Desktop设置此服务器的详细指南,请参阅 WSL,参见 让MCP服务器在WSL中与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"
			]
		}
	}
}

数据库配置

服务器支持本地SQLite和远程libSQL数据库 通过LIB_RESURL环境变量:

对于本地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
  1. 版本包(更新版本和CHANGELOG):
pnpm changeset version
  1. 发布到npm(将提示输入2FA代码):
pnpm release

贡献

欢迎投稿!请阅读我们的投稿指南 在提交pull请求之前。

许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

致谢