内容
# aura-turbo
**用于 AI 代理的压缩持久内存**
> 给你的 AI 助手一个永不遗忘的记忆 — 并将其装入口袋。
aura-turbo 是一个 [MCP（模型上下文协议）](https://modelcontextprotocol.io) 服务器，为 Claude 和其他 AI 助手提供持久的压缩内存存储。记忆在会话之间存活，通过 zlib 压缩以实现高效存储，并可按关键词和标签搜索。
## 功能
- **持久内存** — 基于 SQLite 的存储，在重启后仍然存活
- **zlib 压缩** — 文本内容的典型压缩比例为 3-5 倍
- **三个内存级别** — `core`（永久）、`working`（7 天 TTL）、`ephemeral`（24 小时 TTL）
- **基于标签的组织** — 按标签分类和检索记忆
- **关键词搜索** — 跨所有记忆的 TF-IDF 风格的相关性评分
- **自动过期** — 短暂和工作记忆自动清理
- **重复数据删除** — 内容哈希防止存储相同的记忆两次
- **零外部依赖** — 仅使用 Python 标准库（zlib、sqlite3）加上 MCP SDK
## 安装
```bash
pip install aura-turbo
```
或克隆并直接运行：
```bash
git clone https://github.com/aura-turbo/aura-turbo.git
cd aura-turbo
pip install -e .
```
## 快速入门
直接运行服务器：
```bash
python server.py
```
### Claude 桌面配置
将以下内容添加到您的 Claude 桌面 MCP 配置文件（`claude_desktop_config.json`）：
```json
{
"mcpServers": {
"aura-turbo": {
"command": "python",
"args": ["/path/to/aura-turbo/server.py"]
}
}
}
```
或如果通过 pip 安装：
```json
{
"mcpServers": {
"aura-turbo": {
"command": "aura-turbo"
}
}
}
```
### 自定义数据库位置
设置 `AURA_TURBO_DB` 环境变量以使用自定义数据库路径：
```json
{
"mcpServers": {
"aura-turbo": {
"command": "python",
"args": ["/path/to/aura-turbo/server.py"],
"env": {
"AURA_TURBO_DB": "/path/to/my-memories.db"
}
}
}
}
```
默认位置：`~/.aura-turbo/memories.db`
## 工具
### `memory_store`
存储一个记忆，并附带可选的标签和重要性级别。
```
content: "用户偏好暗黑模式并使用 vim 键绑定"
tags: ["偏好", "编辑器"]
level: "core"
```
### `memory_recall`
按关键词或短语搜索记忆。返回排名结果。
```
query: "编辑器偏好"
limit: 5
```
### `memory_forget`
按 ID 删除特定记忆。
```
memory_id: 42
```
### `memory_stats`
显示存储统计信息 — 总记忆数、压缩比率、节省空间。
### `memory_search_by_tag`
查找具有特定标签的所有记忆。
```
tag: "偏好"
```
### `memory_clear_expired`
删除超过 24 小时的短暂记忆和超过 7 天的工作记忆。核心记忆永远不会被删除。
## 压缩工作原理
aura-turbo 使用 Python 内置的 `zlib` 库（实现 DEFLATE/gzip 压缩）来压缩内存内容，然后存储在 SQLite 中。
| 内容类型 | 典型压缩比例 |
|---|---|
| 英文散文 | 3-4 倍 |
| 代码片段 | 3-5 倍 |
| JSON/结构化数据 | 4-6 倍 |
| 已经压缩的内容 | 约 1 倍 |
1KB 的对话摘要压缩到约 250-300 字节。数百个记忆下来，这带来了显著的空间节省，同时将所有内容保存在一个便携的 SQLite 文件中。
## 比较
| 功能 | aura-turbo | Mem0 | 自定义 RAG |
|---|---|---|---|
| 价格 | **免费** | 249 美元/月 | 变动 |
| 存储 | 本地 SQLite | 云 | 云/本地 |
| 依赖项 | 仅 MCP SDK | 许多 | 许多 |
| 压缩 | zlib（3-5 倍） | 无 | 无 |
| 设置时间 | 1 分钟 | 账户设置 | 数小时 |
| 隐私 | **100% 本地** | 云 | 取决于 |
| MCP 原生 | 是 | 否 | 否 |
## 架构
```
Claude/AI <--MCP--> server.py <--> storage.py <--> SQLite + zlib
|
~/.aura-turbo/
memories.db
```
## 许可证
MIT
