sabmemory (Sablinova)

sabmemory

轻量级Rust MCP内存服务器。接近零的RAM替代了基于嵌入式的存储系统。

~6 MB RAM 在生产中。单个4.1 MB静态二进制文件。没有Python，没有Node.js，没有ML运行时，没有外部依赖。内置网络仪表板，具有知识图可视化功能。

为什么是sabmemory？

每个其他MCP内存服务器都需要大量的运行时（Python/Node.js）、用于嵌入的ML模型或云API调用。sabmemory使用SQLite FTS5全文搜索而不是向量嵌入——以资源成本的一小部分实现快速、相关的搜索。

与其他MCP内存服务器的比较

概述

\*星号显示的是modelcontextprotocol/servers monorepo，而不是内存包。

特性

运行时和依赖关系

搜索质量权衡

sabmemory以语义相似性换取资源效率。FTS5+BM25执行关键字感知排名搜索，而不是意义感知向量搜索。在实践中，这对于MCP内存用例来说效果很好，因为：

1. 记忆是简短的原子笔记，带有明确的关键字和标签
2. 编写内存的代理与搜索内存的代理是同一个代理——它使用一致的术语
3. 无论词汇匹配如何，重要性得分提升都会显示最相关的结果
4. 通过FTS5相似性自动链接在写入时捕获相关概念

对于需要真正语义搜索的用例（在搜索“car”时找到“automotive”），基于嵌入的服务器（如mcp内存服务或Forgetful）更合适。

在2 GB VPS（Ubuntu 24.04）上测量。 sabmemory RSS:6.5 MB Ps正在使用中，包含19个内存、2个实体、2个项目和1个文档。空闲实例降至约2 MB。

特性

• 49个本地MCP工具 --内存、实体、项目、文档、代码工件、关系、配置文件、版本控制
• FTS5全文搜索 BM25排名+重要性得分提升
• 内存版本控制 --具有关系类型（更新/扩展/派生）的版本链，灵感来自 超级存储器
• 自动遗忘 --set forget_after 自动到期日期；软遗忘与过时的区别
• 集装箱范围界定 — container_tag 命名空间隔离字段
• 自动链接 --新存储器通过FTS5自动链接到类似的现有存储器
• 代币预算搜索 --结果受可配置令牌预算的限制（默认8000）
• 知识图谱 --具有类型化关系、双向内存链接的实体
• 文档和代码工件 --存储长格式内容和可重用代码片段
• 用户配置文件 --从高重要性记忆（静态+动态事实）自动生成
• 内置迁移 --从导入数据 健忘 数据库

安装

来源

git clone https://github.com/Sablinova/sabmemory.git
cd sabmemory
cargo build --release
cp target/release/sabmemory ~/.local/bin/

需求

• Rust 1.70+（使用2021版）
• 没有其他依赖关系——SQLite是通过rusqlite捆绑的

用法

MCP服务器（stdio）

sabmemory serve
# or just:
sabmemory

服务器使用MCP协议通过stdin/stdout进行通信。在MCP客户端中配置它。

OpenCode配置

{
  "mcp": {
    "sabmemory": {
      "type": "local",
      "command": ["/path/to/sabmemory", "serve"],
      "enabled": true
    }
  }
}

从健忘的ai迁移

sabmemory migrate --from ~/.local/share/forgetful/forgetful.db

迁移：项目、实体、内存、文档、代码工件、关系和所有关联。FTS索引在迁移后会自动重建。

数据存储

数据库： ~/.local/share/sabmemory/sabmemory.db

数据库在首次运行时自动创建。所有数据都存储在一个带有FTS5虚拟表的SQLite文件中，用于全文搜索。

建筑

搜索策略

1. 自然语言查询被标记为FTS5搜索词
2. FTS5 MATCH与BM25排名分数相关性
3. 帖子过滤器：过时、遗忘、过期、项目、标签、容器、min_importance
4. 重要性得分提升应用于最终排名
5. 代币预算执行限制了结果大小
6. 链接内存扩展增加了链接知识

内存模型

记忆遵循Zettelkasten（原子音符）原则：

• 标题：简短，可搜索（最多200个字符）
• 内容：单个概念（最多2000个字符）
• 上下文：为什么这很重要（最多500个字符）
• 关键词：用于搜索聚类（最多10个）
• 标签：用于分类（最多10个）
• 重要性：1-10分影响搜索排名和个人资料生成

版本控制（受超级内存启发）

记忆可以通过以下方式形成版本链 parent_memory_id:

• 更新：新版本与父版本相矛盾/替换父版本
• 扩展：新版本丰富了父版本
• 源自：系统推断关系

只有最新版本(is_latest=true)出现在搜索结果中。

自动忘记

集 forget_after （ISO 8601日期）存储在内存中。在每次查询之前，过期的内存会自动标记为遗忘。被遗忘的记忆被排除在搜索之外，但保留以供审计。

工具参考

记忆工具（13）

实体工具（15）

项目工具（5）

文档工具（5）

代码工件工具（5）

用户和配置文件工具（4）

元工具（2）

Web仪表板

sabmemory包括一个内置的web仪表板，用于可视化您的知识图、浏览记忆和探索实体/项目/文档。

运行仪表板

sabmemory dashboard --port 3080

仪表板在 http://localhost:3080 并提供：

• 知识图谱 --所有记忆、实体及其连接的交互式Three.js WebGL 3D可视化
• 内存浏览器 --包含重要性、标签和元数据的所有记忆的可搜索列表
• 实体资源管理器 --查看实体、其类型、别名和关系
• 项目视图 --具有相关内存计数的项目
• 文档视图 --存储的长格式文档
• 搜索 --在所有记忆中进行全文搜索
• 细节模态 --单击任何内存以查看完整内容、链接和关联

仪表板API

仪表板在上公开了一个REST API /api/:

作为systemd服务运行

# Create user service
mkdir -p ~/.config/systemd/user
cat > ~/.config/systemd/user/sabmemory-dashboard.service << 'EOF'
[Unit]
Description=sabmemory web dashboard
After=network.target

[Service]
ExecStart=%h/.local/bin/sabmemory dashboard --port 3080
Restart=on-failure
RestartSec=5

[Install]
WantedBy=default.target
EOF

# Enable and start
systemctl --user daemon-reload
systemctl --user enable --now sabmemory-dashboard

反向代理（nginx）

要使用HTTPS为反向代理后面的仪表板提供服务，请执行以下操作：

server {
    listen 443 ssl;
    server_name memory.yourdomain.com;

    location / {
        proxy_pass http://127.0.0.1:3080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

积分

sabmemory的灵感来自并建立在以下想法之上：

• 超级存储器 --内存版本控制链、带过期的自动遗忘、基于容器的作用域、自动生成的用户配置文件、内存类型分类
• 健忘 --知识图架构（实体、关系、内存实体关联）、文档和代码工件存储、基于项目的组织、原子内存原理

许可证

麻省理工学院