AI代理压缩持久内存

aura-turbo是一个为Claude等AI助手提供持久、压缩内存存储的MCP服务器,支持跨会话记忆保存、压缩存储及关键字和标签搜索。

  • by ShipItAndPray
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 ShipItAndPray/aura-turbo

使用说明

光环涡轮

AI代理的压缩持久内存

给你的人工智能助手一个永远不会忘记的记忆,放在你的口袋里。

光环涡轮是 MCP(模型上下文协议) 为Claude和其他人工智能助手提供持久、压缩内存存储的服务器。内存在会话中存活,用zlib压缩以实现高效存储,并且可以通过关键字和标签进行搜索。

特性

  • 持久内存 --重启后仍能存活的SQLite支持的存储
  • zlib压缩 --文本内容的典型3-5x压缩
  • 三个内存级别 — core (永久), working (7天TTL), ephemeral (24小时TTL)
  • 基于标签的组织 --按标签对记忆进行分类和检索
  • 关键字搜索 --TF IDF风格在所有记忆中的相关性评分
  • 自动到期 --短暂和工作记忆会自行清理
  • 去重 --内容哈希可防止两次存储相同的内存
  • 零外部依赖 --仅使用Python stdlib(zlib、sqlite3)和MCP SDK

安装

pip install aura-turbo

或者克隆并直接运行:

git clone https://github.com/aura-turbo/aura-turbo.git
cd aura-turbo
pip install -e .

快速开始

直接运行服务器:

python server.py

Claude桌面配置

添加到您的Claude Desktop MCP配置(claude_desktop_config.json):

{
  "mcpServers": {
    "aura-turbo": {
      "command": "python",
      "args": ["/path/to/aura-turbo/server.py"]
    }
  }
}

或者,如果通过pip安装:

{
  "mcpServers": {
    "aura-turbo": {
      "command": "aura-turbo"
    }
  }
}

自定义数据库位置

设置 AURA_TURBO_DB 使用自定义数据库路径的环境变量:

{
  "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: "The user prefers dark mode and uses vim keybindings"
tags: ["preferences", "editor"]
level: "core"

memory_recall

按关键字或短语搜索记忆。返回排名结果。

query: "editor preferences"
limit: 5

memory_forget

按ID删除特定内存。

memory_id: 42

memory_stats

显示存储统计数据——总内存、压缩比、节省的空间。

memory_search_by_tag

查找带有特定标签的所有记忆。

tag: "preferences"

memory_clear_expired

删除超过24小时的短暂记忆和超过7天的工作记忆。核心记忆永远不会被删除。

压缩是如何工作的

aura-turbo使用Python的内置 zlib 库(实现DEFLATE/gzip压缩)在将内存内容存储到SQLite之前对其进行压缩。

内容类型 典型比率
英语散文 3-4x
代码片段 3-5x
JSON/结构化数据 4-6x
已压缩 ~1x

1KB的对话摘要压缩到约250-300字节。在数百个内存中,这大大节省了空间,同时将所有内容保存在一个可移植的SQLite文件中。

比较

功能 光环涡轮 Mem0 定制RAG
价格 免费 249美元/月 各不相同
存储 本地SQLite 云 云/本地
依赖关系 仅限MCP SDK 许多 许多
压缩 zlib(3-5x) 无 无
设置时间 1分钟 帐户设置 小时
隐私权 100%本地 云 取决于
MCP本机 是 否 否

建筑学

Claude/AI <--MCP--> server.py <--> storage.py <--> SQLite + zlib
                                        |
                                   ~/.aura-turbo/
                                    memories.db

许可证

麻省理工学院