MCP

Remnic:给 AI agent 装上本地优先的共享记忆库

最适合为本地多个 AI agent 搭一个共享、透明、可溯源的记忆库,前提是你能运行 Node.js 22.12+ 并接受记忆以 markdown 文件明文存在本机磁盘上。

官方来源 · GitHub - joshuaswarren/remnic

安装

npm install -g @remnic/cli && remnic init && remnic daemon start && remnic status

适合谁

  • 适合想让 AI 助手拥有跨会话、跨多个 agent 共享记忆的个人开发者:记忆以带 YAML frontmatter 的普通 markdown 文件存在你自己的磁盘上,搜索索引可从这些文件重建,无需外部数据库服务。MIT 开源、本地优先。
  • 适合同时使用多个 agent、希望「一个记忆库,每个 agent 都能用」的场景;除存储与召回外,MCP 工具面还包括实体查找、记忆纠正、按时间召回、X-ray 来源溯源、每日简报、工作看板和连续性工具。
  • 不适合的情况:需要 Node.js 22.12 或更新版本,旧版环境无法使用。支持远程部署的程度(docker、托管服务等)证据中未说明,如有此类需求请先自行确认。

3 分钟完成第一次尝试

推荐主路径是官方 CLI 全流程:

  1. 前提:安装 Node.js 22.12 或更新版本(nodejs.org)。
  2. 安装并初始化:
npm install -g @remnic/cli
remnic init

remnic init 会写入 remnic.config.json 配置文件(本地状态写入,属于正常初始化步骤)。全局安装同时会安装 remnic 命令,以及遗留的 engram 转发器命令。

  1. 启动并确认:
remnic daemon start
remnic status

remnic status 正常返回即为成功信号,说明后台服务已运行,可以接入客户端。独立运行方式下,daemon 可作为暴露 MCP 工具的 HTTP 端点(官方也提供 @remnic/server 运行方式,作为次要选择)。首次验证建议只用 remnic status 这类状态确认动作,再进行真实存储。

注意区分:remnic init 和后续记忆写入都会写本地磁盘,不是只读操作;remnic status 是查看运行状态的低风险确认。

使用案例

  • 案例:存储一条记忆后召回。daemon 运行后,把一条事实存入记忆库,再通过 MCP 调用召回能力查询它。记忆记录是磁盘上带 YAML frontmatter 的 markdown 文件(如 category: decision 这类结构),成功后你可以在本地文件里直接看到这条记录,并从 agent 端召回。证据未提供 store/recall 工具的确切调用参数示例,具体参数请以 MCP 客户端列出的工具说明为准。
  • 案例:用每日简报/连续性工具接续昨天的工作。连接 MCP 端点后,客户端会列出 Remnic 的工具面,其中包含 daily briefing(每日简报)、work-board(工作看板)和 continuity(连续性)工具;调用简报类工具即可基于已有记忆得到当前状态概览。工具名精确拼写以客户端展示的工具列表为准,证据未逐一列出。

使用边界

  • Remnic 是本地读写系统:存储记忆会向磁盘写入 markdown 文件,纠正记忆会修改已有内容;证据中未说明内置的撤销/回滚路径,不应视为可自动撤销。删除与备份依赖你对本地文件的管理。
  • 记忆以明文 markdown 存在本地磁盘,谨慎存储敏感信息;README 对隐私与脱敏策略的具体说明证据中未见,未知。
  • 服务要求 Node.js ≥ 22.12;客户端连接的端口、鉴权等细节证据未披露,如需网络暴露请先查阅官方文档确认。
  • 未确认项(隐私策略、工具完整参数、远程部署)均以官方仓库最新 README 为准。