Mnemo Cortex
为 AI 代理打造的本地优先认知协处理器:主动记忆、语义召回、跨代理共享,无需云端。
- Star 数
- ★ 161
- 最近更新
- 1 天前
- License
- MIT
- 主语言
- Python
- FA 评分
- 75/100 · 表现良好
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code · Claude.aiChatGPT(部分支持)
- 费用
- 免费,无需付费服务
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 同时使用多个 AI 代理(如 Claude Code、Claude Desktop、Codex CLI、Hermes)的个人开发者,希望代理 A 能查到代理 B 学到的内容
- 不适合
- 需要云端托管、零部署成本的团队
- 要求 OpenAI 云连接器直连自托管 MCP 的用户
- 希望零配置一键启动、不愿维护本地服务的用户
- 官网
- projectsparks.ai ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-19最新版本 v4.28.4(2026-11-12)
- 源码审查
- 75/100 · 表现良好
这个 Agent 能做什么,适合哪些场景?
Mnemo Cortex 是一个自托管的“认知协处理器”,为 AI 代理提供持久、本地、跨代理的记忆。它从外部监听代理的会话文件(如 OpenClaw / Claude Code 的 JSONL),将每条消息写入本地 SQLite 数据库,并用本地 Ollama 模型(默认 qwen2.5:32b-instruct)做滚动压缩,生成约 80% 的 token 节省。系统以 API 服务器(默认 http://localhost:50001)形式运行,通过 MCP 桥接供 Claude Desktop、LM Studio、AnythingLLM、OpenClaw、Agent Zero、Hermes 等客户端使用;ChatGPT 则通过一个加固的两路由 REST 网关接入,而非 MCP。核心组件包括:智能分层的智能笔记/会话日志记忆、带置信度阶梯与权威分级的结构化事实库、夜间跨代理“做梦”合成、全工作区文档索引 The Librarian(SQLite FTS5)、USB 快递同步 Cortex Stick、代理间消息总线 Disco-Bus,以及防篡改的 Memory Ledger。作者称其自 2026 年 3 月起作为五代理车队的生产记忆运行,累计约 1 万条记忆与约 7 千条已验证事实,84 个已发布版本。
运行 mnemo-cortex start 后,API 服务器监听 50001 端口;mnemo-cortex watch --backfill 启动会话文件监听器,每 2 秒读取代理的 JSONL 会话文件并自动摄取消息(无需钩子或修改代理)。保存时按两层分类:Tier 1 智能笔记由推理模型归入八个类别(topology、current_state、doctrine、incident、identity、relationship、decision 等),Tier 2 存放原始会话日志,默认召回只返回 Tier 1。召回同时运行语义向量搜索与 BM25 关键词搜索(SQLite FTS5),v4.22 起还支持按辅音骨架键匹配拼写错误的专有名词。结构化事实以 (entity, attribute, value) 三元组存储,经 verified→high_probability→false 置信度阶梯自动升降级,并提供 mnemo_fact_save / mnemo_fact_get / mnemo_fact_query / mnemo_fact_demote 四个 MCP 工具。夜间做梦流程对每个代理的近期记忆做 map-reduce 主题压缩,再跨代理合并为共享简报。mnemo-cortex health 验证服务器、数据库、压缩模型与各代理召回;mnemo-cortex stick sync 通过可选 AES-256 加密的 U 盘在两台机器间同步增量。
- 同时使用多个 AI 代理(如 Claude Code、Claude Desktop、Codex CLI、Hermes)的个人开发者,希望代理 A 能查到代理 B 学到的内容
- 在两台机器间切换工作的用户,希望用 Cortex Stick 通过加密 U 盘同步代理记忆,不依赖云或 VPN
- 使用 LM Studio、Open WebUI、Ollama、AnythingLLM 等本地 LLM 的用户,想给模型加上持久语义记忆且零 API 费用
- 拥有 ChatGPT Plus 的用户想给 Custom GPT 一个自己掌控的记忆,通过两路由网关而非暴露公网服务器
- 需要代理记住精确事实(姓名、配置、标识符)而非模糊语义的用户,可使用结构化事实库与 BM25 精确匹配
- 运行多代理工作流的团队,希望夜间做梦自动产生跨代理共享简报,并经 Lane Protocol 流程激活记忆
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
pip install -e
- 环境变量
BRAIN_DIR- 配置文件
~/.agentb/agentb.yaml- 运行环境
- Python 3.11+ · Node.js 18+
- 安装说明涉及
- Windows · macOS
如何安装或部署这个 Agent?
前置要求:Python 3.11+、可选的 Ollama(推荐,本地推理与嵌入)、MCP 桥接集成时需要 Node.js 18+。从源码安装:
bash
git clone https://github.com/GuyMannDude/mnemo-cortex.git
cd mnemo-cortex
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activatepip install -e .
这会注册 mnemo-cortex(别名 mnemo)两个 CLI 命令。非交互式安装(供 LLM 代理或 CI 使用):
bash
./robot-install.sh该脚本在 stdout 输出一个 JSON 对象(ok、steps 等),进度写入 stderr;可用 MNEMO_INSTALL_DRY_RUN=1 等环境变量做沙盒演练。macOS 有专门的安装指南(docs/install-macos.md),Windows 自 v4.4.1 起原生支持。
如何使用这个 Agent?
五步流程:
bash
mnemo-cortex init # 交互式向导:选择推理/嵌入模型、绑定地址与端口,写入 ~/.agentb/agentb.yaml
mnemo-cortex start # 后台启动服务器,默认监听 http://localhost:50001
mnemo-cortex health # 14 项健康检查;也可用 mnemo-cortex doctor 做深度诊断
启动自动捕获:
bash
mnemo-cortex watch --backfill或在 shell 配置中 export MNEMO_AUTO_CAPTURE=true 使其随服务器自启。然后按平台接入:Claude Code 使用 integrations/claude-code/;Claude Desktop 用一键 .mcpb 包;LM Studio / AnythingLLM / OpenClaw / Agent Zero 等通过一行 MCP 配置;ChatGPT 通过 Custom GPT Actions 调用两路由网关(需 Plus 或更高级别)。直接 API 调用示例:
bash
curl -s -X POST http://localhost:50001/context \
-H "Content-Type: application/" \
-d '{"prompt": "what happened today", "agent_id": "YOUR-AGENT-ID", "max_results": 5}'推荐搭配 mnemo-plan 脑仓(fork 模板仓库并把 BRAIN_DIR 指向它)与 THE-LANE-PROTOCOL.md 会话操作规程。
这个 Agent 有哪些优点和局限?
- 唯一实现跨代理夜间做梦合成——夜间将各代理记忆压缩为主题并合并为共享简报,代理间互知对方做了什么
- 完全本地优先:无遥测、无云端依赖、SQLite 单文件存储,嵌入与压缩用本地 Ollama 模型,运行成本为零
- 多层召回:语义向量 + BM25 关键词(SQLite FTS5)+ 拼音骨架模糊名匹配,文档实测 11/11 精确命中优于纯向量
- 结构化事实库带置信度阶梯、权威分级(probe/declared/open)与防篡改 Memory Ledger,错误记忆可经 /memories/demote 降级
- 生态完善:五平台安装指南、robot-install 非交互安装、health/doctor 诊断、Disco-Bus 代理总线、The Librarian 文档索引(索引约 10.7 万文件,全量重建约 17 秒)
- 需要持续运行的本地服务器进程(默认 127.0.0.1:50001),并需自行配置 systemd/launchd/Task Scheduler 保持开机自启
- 依赖 Ollama 本地模型做压缩与嵌入(默认 qwen2.5:32b-instruct 与 nomic-embed-text),嵌入模型名更换需手动排查,否则召回返回空结果
- ChatGPT 无法走标准 MCP,须通过定制网关且 OpenAI 套餐有等级限制(Plus 上自定义 MCP 连接器只读)
- 权威分级目前是审计加荣誉制,尚未真正强制阻止代理写入锁定的槽位
- 个人/小团队项目,作者自称非开发者,文档中大量日期为 2026 年,长期维护与社区规模缺乏独立验证
这个 Agent 与同类方案有什么区别?
作者明确与 OpenClaw 2026.4.10 原生 Active Memory 插件对比:后者是单代理、按工作区隔离的本地草稿本,Mnemo 是跨代理、跨机器的中心化 SQLite + 嵌入存储,两者可叠加使用。同时自述与 Mem0、Zep、Letta 不同:它们按代理存储记忆,Mnemo 是唯一做跨代理合成的(原文表述)。ChatGPT 侧与常见 MCP 自托管服务器不同——出于安全不暴露 HTTPS,改用加固的两路由网关。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Mnemo Cortex 当前 | 75 · 表现良好 | 自托管服务免费 | ★ 161 | 1 天前 | Python | Codex · Claude Code · Claude.ai |
| Compartment | 73 · 存在缺口 | 命令行工具免费 | ★ 473 | 3 天前 | Python | Codex · Claude Code |
| Remnic 智能体记忆 | 73 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 235 | 今天 | TypeScript | ChatGPT · Codex · Claude Code · OpenAI API |
| Emulo | 76 · 表现良好 | Agent 插件 / 技能免费 + 模型费 | ★ 306 | 1 个月前 | HTML | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
证据显示本地部署、租户隔离、工具权限提示、ChatGPT gate 的认证/限流/请求体限制/审计,以及秘密文件保护均有具体说明;gate 将流量限制为两个操作且固定租户。扣分因 MCP 工具授权范围和核心服务各端点权限在样本中不完整,部分设置仍需用户自行判断,USB 同步虽称冲突保留但回滚细节有限。
CI 配置覆盖 pytest、wheel smoke 和 Docker 启动,文档也提供健康检查与故障排查。扣分因README称默认绑定 loopback,而 macOS 指南称初始化默认绑定 0.0.0.0,样本无法消解该配置矛盾;依赖范围较宽,且仅最新发布版获安全修复。
文档覆盖多种 MCP 客户端、Windows/Linux/macOS、共享/隔离部署,并清楚列出不适用情形和 ChatGPT gate 约束。扣分因不同指南和兼容性主张较多,部分依赖客户端或模型的支持边界仍需使用者核实;触发规则主要在技能说明中,覆盖面有限。
文档目录、跨平台安装、常见问题、已知限制、MIT 许可和安全报告方式均清楚。扣分因技能版本为 0.1.0、包版本为 4.28.4,且 README 的版本/发布日期叙述与快照版本无法在样本中完全对应;单人维护和仅支持最新版有说明,但没有可验证的发布责任人身份。
产品将持久记忆、语义与词法检索、事实存储和跨代理同步组合为明确能力,并提供多种安装路径与操作示例。扣分因实际收益数字主要是作者部署陈述,无法由本静态样本独立验证;配置、模型服务及维护成本仍由用户承担。
配置项、API 行为、安全机制、安装步骤和若干功能描述可在代码与文档样本之间对照,且文档明确提示验证工具调用和区分推测与事实。扣分因大量性能、规模、独特性和使用效果数字属于项目自述,样本中的 CI 仅展示工作流配置而非本次 revision 的执行结果;对事实与推断的标注并非全局一致。
- README 与 macOS 安装指南对初始化后的默认监听地址说法不一致;部署前应检查实际配置,并避免在未启用认证时对外监听。
- ChatGPT gate 需要公开 HTTPS 入口;其安全边界依赖独立 gate token、固定租户和正确的代理配置。
- 种子事实定时重跑可能覆盖后来修正的事实;修改事实时也应同步更新种子文件。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
v4.28.4 v4.28.4 — Anthropic provider on Sonnet 5.5; Claude Desktop bundle rebuilt (reinstall it)
发布说明摘录
Anthropic provider (PR #25, thanks @SamHofmannOfficial). The setup wizard's Anthropic default is now claude-sonnet-5-5 (claude-sonnet-4-5-20250929 retires 2026-11-30), and AnthropicReasoning.generate no longer raises KeyError when a reply starts with a thinking block. Claude Desktop bundle rebuilt on bridge 2.40.1 — reinstall if you use it. The one-click mnemo-cortex.mcpb had not been rebuilt since July and still carried bridge 2.17.0. That means it was missing the wiki_search security fix announced in v4.28.1 (GHSA-h2jf-xmmf-2w8p). If you installed the bundle before 2026- …在 GitHub 查看 ↗ -
v4.28.1 v4.28.1 — SECURITY: wiki_search no longer runs a shell (GHSA-h2jf-xmmf-2w8p)
发布说明摘录
Security fix — MCP bridge 2.40.1. The read-only wiki_search tool built a shell command string with the query inside double quotes; $(...) and backticks expand there, so a search term shaped that way ran commands as the bridge user. CVSS 3.1 7.8 (local stdio; needs a wiki directory to exist and the host to invoke the search with attacker-chosen text). The Mnemo server itself is unaffected. grep now receives its arguments directly with no shell (wiki-search.js). wiki-search.test.js covers eight injection shapes plus option- and path-shaped queries. Behaviour is otherwise unchanged. …在 GitHub 查看 ↗ -
v4.27.0 v4.27.0 — SECURITY: no wildcard CORS, foreign origins and hosts refused without auth
发布说明摘录
Problem. GHSA-682p-grrx-wrwg (high, reported 2026-08-20 by kasparovabi). The server shipped cors_origins: ["*"] by default, and the default auth posture is none. A browser on the same machine is a loopback client, so any web page the user visited could read /facts, /sessions, transcripts and dreams, write facts, pause capture, and plant trajectories — the loopback peer check never saw a difference. A DNS-rebinding page did the same with no Origin header at all. Deployments with auth_token or scoped tokens were not affected (the token is the gate, and a page cannot attach it). …在 GitHub 查看 ↗
常见问题
使用 Mnemo Cortex 需要付费吗?
ChatGPT 能直接连上吗?
召回结果为空怎么办?
是否已有生产验证?
代理会看到彼此的记忆吗?隐私如何?
Mnemo Cortex 官网是什么?
Mnemo Cortex 开源吗?
Mnemo Cortex 还在维护吗?
Mnemo Cortex 是谁开发的?
谢谢反馈,我们会据此改进页面。