MCP内存系统
一种高性能的持久内存系统，用于模型上下文协议（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"
}
}
}
}该服务需要配置环境变量：LIBSQL_AUTH_TOKEN、LIBSQL_URL
可用工具 （6 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
create_entities 1 个参数 需填 1 项
Create new entities with observations and optional embeddings
必填参数：entities
search_nodes 2 个参数 需填 1 项
Search for entities and their relations using text or vector similarity
必填参数：query
read_graph 1 个参数
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
一个高性能的持久内存系统，用于支持由 libSQL 提供动力的模型上下文协议 (MCP)。此服务器使用 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 桌面与 WSL 配置
有关在 WSL 中使用 Claude 桌面设置此服务器的详细指南，请参阅 让 MCP 服务器在 WSL 的 Claude 桌面中工作。
对于 WSL 环境，请将以下内容添加到您的 Claude 桌面配置中：
{
"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 提供支持
