mnema

Mnema

为 AI Agent 提供本地优先、经形式化验证的记忆——通过 MCP，一个共享存储，适用于所有客户端。

你的 Agent 向实验室租用智能；它们的记忆应当属于你。 Mnema 是一个持久存储，用来保存 Agent 学到的内容——行动前先 consult， 记录持久事实时使用 learn，浏览 related 图，查看最近内容时使用 list。 数据保存在你机器上的 ~/.mnema 中，除非你指定其他位置，否则不会离开本机。

• 经验证的引擎。 嵌入式 engram 数据库经过形式化规范定义和机器校验（属性目录由 250 多项测试验证通过，并通过穷举式 CRDT 一致性模型检查器、Kani 证明和 TLA⁺ 模型验证）。每个已发布的二进制文件都在其对应的精确提交上通过了这套验证。
• 本地优先。 数据存储在 ~/.mnema 中，采用开放的仅追加分段格式。无云端，无需账户。
• 一个存储，适用于所有客户端。 Claude Code、Claude Desktop、Cursor、你的脚本和 CI 都使用同一份记忆。回忆功能结合词法检索与图传播激活（也可选用语义嵌入），并为每个回答提供诚实的置信区间。

此代码仓库提供公开发布包（.mcpb）和预编译二进制文件。产品、文档和下载内容位于 mnema.zimac.ai。

安装

从 MCP Registry 安装（推荐）

Mnema 已发布到官方 MCP Registry，名称为 ai.zimac/mnema。任何支持 Registry 的客户端都可以按名称安装；它会从此代码仓库的发布内容中获取对应平台的 .mcpb 包，并验证其 fileSha256。

.mcpb 安装包（手动）

从最新发布版本下载适用于你平台的安装包，并用支持 MCP 安装包的客户端打开（例如 Claude Desktop → Extensions）：

平台	文件
macOS（通用版）	mnema-<version>-macos-universal.mcpb
Linux（x86_64）	mnema-<version>-linux-x86_64.mcpb

.mcpb 是一个 ZIP 文件，包含 manifest.json、mnema 二进制文件和本 README。 每个安装包都会在发布前经过试运行验证（其中的二进制文件会完成 MCP initialize 握手）。

无头二进制文件（curl | sh）

适用于 Agent、脚本和 CI——安装独立的 mnema 二进制文件：

curl -fsSL https://mnema.zimac.ai/install.sh | sh

（预编译版本适用于 macOS 通用版和 Linux x86_64；其他平台会从源代码构建。macOS GUI 应用可从 mnema.zimac.ai 单独下载。）

为你的 Agent 提供记忆

claude mcp add mnema -- mnema mcp

设置就这么简单：如果共享本地存储尚未运行，mnema mcp 会自动启动它；会话将获得四个工具——consult（行动前搜索）、learn（记录持久事实）、related（图中的邻居）、list（浏览）。任何 MCP 客户端都能使用；通用配置如下：

{ "mcpServers": { "mnema": { "command": "mnema", "args": ["mcp"] } } }

指向共享／团队存储

同一个二进制文件也可以连接到远程 Mnema（受令牌保护的 mnema serve 或托管的 learnings pod），而非本地存储：

MNEMA_URL=https://memory.example.com MNEMA_TOKEN=<secret> mnema mcp

使用非回环 URL 时不会自动启动任何服务——这只是一个经过身份验证的纯桥接。

配置

环境变量	默认值	说明
MNEMA_DATA_DIR	~/.mnema	存储的位置
MNEMA_URL	http://127.0.0.1:7077	CLI／MCP 桥接所连接的存储
MNEMA_TOKEN	—	远程存储的 Bearer 凭据

链接

• 产品与下载： https://mnema.zimac.ai
• Registry 条目： https://registry.modelcontextprotocol.io 上的 ai.zimac/mnema
• 发布内容（.mcpb 和二进制文件）： https://github.com/Zimac-AI/mnema/releases

---

Mnema 是 Zimac 的项目。