Mnemo Cortex

为 AI 代理打造的本地优先认知协处理器:主动记忆、语义召回、跨代理共享,无需云端。

Star 数
★ 161
最近更新
1 天前
License
MIT
主语言
Python

30 秒速览

运行形态
自托管服务MCP 服务器命令行工具
可在哪里用
通用 · 跨平台Codex · Claude Code · Claude.aiChatGPT(部分支持)
费用
免费,无需付费服务
上手难度
中 · 需要几步配置
开始前需要
Python 3.11+SQLite FTS5Ollama(推荐)Node.js 18+(仅 MCP 桥接集成时需要)Shell / 命令行网络访问本地文件系统MCP Server
典型场景
同时使用多个 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)

这个 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 盘在两台机器间同步增量。

  1. 同时使用多个 AI 代理(如 Claude Code、Claude Desktop、Codex CLI、Hermes)的个人开发者,希望代理 A 能查到代理 B 学到的内容
  2. 在两台机器间切换工作的用户,希望用 Cortex Stick 通过加密 U 盘同步代理记忆,不依赖云或 VPN
  3. 使用 LM Studio、Open WebUI、Ollama、AnythingLLM 等本地 LLM 的用户,想给模型加上持久语义记忆且零 API 费用
  4. 拥有 ChatGPT Plus 的用户想给 Custom GPT 一个自己掌控的记忆,通过两路由网关而非暴露公网服务器
  5. 需要代理记住精确事实(姓名、配置、标识符)而非模糊语义的用户,可使用结构化事实库与 BM25 精确匹配
  6. 运行多代理工作流的团队,希望夜间做梦自动产生跨代理共享简报,并经 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\activate

pip 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?

FollowAgents 源码审查 · FARS-2.1
表现良好
75/ 100 五分制 3.8 / 5
本评测基于 2026年11月8日 的源码;此后该项目发布了 1 个正式版本,尚未复审。分数与结论只代表评测时的版本。 最近版本 ↓
信任安全 22/29
可靠稳定 8/14
适用触发 15/18
规范维护 15/18
有效结果 10/13
证据核验 5/8
查看各维度的扣分理由
信任安全22 / 29 · 3.8/5

证据显示本地部署、租户隔离、工具权限提示、ChatGPT gate 的认证/限流/请求体限制/审计,以及秘密文件保护均有具体说明;gate 将流量限制为两个操作且固定租户。扣分因 MCP 工具授权范围和核心服务各端点权限在样本中不完整,部分设置仍需用户自行判断,USB 同步虽称冲突保留但回滚细节有限。

可靠稳定8 / 14 · 2.9/5

CI 配置覆盖 pytest、wheel smoke 和 Docker 启动,文档也提供健康检查与故障排查。扣分因README称默认绑定 loopback,而 macOS 指南称初始化默认绑定 0.0.0.0,样本无法消解该配置矛盾;依赖范围较宽,且仅最新发布版获安全修复。

适用触发15 / 18 · 4.2/5

文档覆盖多种 MCP 客户端、Windows/Linux/macOS、共享/隔离部署,并清楚列出不适用情形和 ChatGPT gate 约束。扣分因不同指南和兼容性主张较多,部分依赖客户端或模型的支持边界仍需使用者核实;触发规则主要在技能说明中,覆盖面有限。

规范维护15 / 18 · 4.2/5

文档目录、跨平台安装、常见问题、已知限制、MIT 许可和安全报告方式均清楚。扣分因技能版本为 0.1.0、包版本为 4.28.4,且 README 的版本/发布日期叙述与快照版本无法在样本中完全对应;单人维护和仅支持最新版有说明,但没有可验证的发布责任人身份。

有效结果10 / 13 · 3.8/5

产品将持久记忆、语义与词法检索、事实存储和跨代理同步组合为明确能力,并提供多种安装路径与操作示例。扣分因实际收益数字主要是作者部署陈述,无法由本静态样本独立验证;配置、模型服务及维护成本仍由用户承担。

证据核验5 / 8 · 3.1/5

配置项、API 行为、安全机制、安装步骤和若干功能描述可在代码与文档样本之间对照,且文档明确提示验证工具调用和区分推测与事实。扣分因大量性能、规模、独特性和使用效果数字属于项目自述,样本中的 CI 仅展示工作流配置而非本次 revision 的执行结果;对事实与推断的标注并非全局一致。

风险与缓解建议
  • README 与 macOS 安装指南对初始化后的默认监听地址说法不一致;部署前应检查实际配置,并避免在未启用认证时对外监听。
  • ChatGPT gate 需要公开 HTTPS 入口;其安全边界依赖独立 gate token、固定租户和正确的代理配置。
  • 种子事实定时重跑可能覆盖后来修正的事实;修改事实时也应同步更新种子文件。
证据充分度:低 评估于 2026年11月8日 审查版本 d351dcb0e2cb 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/mnemo-cortex.svg?lang=zh)](https://followagents.com/zh/agents/mnemo-cortex)
<a href="https://followagents.com/zh/agents/mnemo-cortex"><img src="https://followagents.com/badge/mnemo-cortex.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. 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 查看 ↗
  2. 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 查看 ↗
  3. 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 需要付费吗?
软件本身 MIT 许可、完全免费;用本地 Ollama 模型做压缩与嵌入时运行成本为零。若选择 OpenAI/Google/Anthropic/OpenRouter 作为推理或嵌入提供方,则需自备相应 API 密钥并承担其费用。项目整体靠捐赠维持。
ChatGPT 能直接连上吗?
不能走标准本地 MCP(ChatGPT 无 stdio 传输)。作者提供经 bearer 认证、单租户锁定、限速且审计日志的两路由网关,由 Custom GPT 通过 Actions 调用;需 Plus 或更高级别,且完整自定义 MCP 读写需 Business/Enterprise 套餐。Mnemo 服务器本身不暴露公网。
召回结果为空怎么办?
最常见原因是嵌入模型名与提供方当前模型不匹配(如 Ollama 用 nomic-embed-text、Google 用 gemini_embedding_001,text-embedding-004 已于 2026 年 1 月停用)。更新 ~/.agentb/agentb.yaml 中的嵌入配置即可。
是否已有生产验证?
据 README,自 2026 年 3 月起它是一个五代理车队(CC、Opie、Dreamer、Rocky、Cody,分别运行在 Claude Code、Claude Desktop、Hermes、Codex CLI 上)的日常生产记忆,约 1 万条记忆、约 7 千条已验证事实、五个月 84 个版本;但这些数字来自作者自述,无法独立核验。
代理会看到彼此的记忆吗?隐私如何?
可配置为共享(全队跨代理搜索与做梦)、隔离(每代理/每客户独立存储,零交叉)或混合部署(内部共享 + 面向客户隔离)。数据保存在你控制的本地 SQLite 中,无遥测与第三方服务,可随时读取或删除。
Mnemo Cortex 官网是什么?
Mnemo Cortex 的 GitHub 仓库填写的官网是 https://projectsparks.ai。这个链接由仓库作者设置;源码在 GitHub(GuyMannDude/mnemo-cortex)。
Mnemo Cortex 开源吗?
开源。源码在 GitHub(GuyMannDude/mnemo-cortex),许可证是 MIT。
Mnemo Cortex 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-19,在最近 30 天内。最新版本是 v4.28.4(2026-11-12)。
Mnemo Cortex 是谁开发的?
Mnemo Cortex 由 GitHub 账号 GuyMannDude 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念