neurakeep

NeuraKeep

NeuraKeep 是一套本地优先的 AI Agent 记忆系统。

它为 Claude Desktop、Claude Code、Codex、OpenClaw、类似 Cursor 的工具以及其他 MCP 客户端提供共享的记忆层，并在你自己的设备上运行，且记忆附有来源引用。

功能

• 将 Markdown、文本、JSONL 和 PDF 导入本地知识库
• 保留原始来源，并提取附有引用的记忆提案
• 在记忆成为持久内容之前供你审核
• 跨来源、事实、事件、故障和决策进行搜索
• 将本地应用的导航整理为分组的「探索」「工作流」和「系统」
• 展示 Sigma 知识图谱，支持渐进式展开、聚类、搜索、键盘操作和已保存布局
• 向 Agent 提供 MCP 工具：
  • memory_search
  • memory_read
  • memory_explain_sources
  • memory_save（立即保存新文本，并将结构化记忆加入审核队列）
  • memory_propose_update
  • memory_apply_update

核心原则很简单：Agent 可以立即保存新的来源记忆，但提取出的持久事实仍可供审核，并附有来源引用。

本地安装

要求：

• Node.js 22+
• npm

npm install
npm run build:all
node dist/cli/index.js init --root .umos
node dist/cli/index.js serve --root .umos --host 127.0.0.1 --port 8765 --ui --read-write

打开：

http://127.0.0.1:8765/index.html

免费本地启动

如果你希望在自己的设备上拥有私密且附有来源引用的记忆，请使用本地核心：

• 导入 Markdown、文本、JSONL 或 PDF
• 在应用持久记忆之前审核提取提案
• 通过 stdio 将 Claude、Codex、OpenClaw 或其他 MCP 客户端连接到系统

NeuraKeep 托管版

如果你需要使用 Google 或企业 SAML/OIDC 登录、私密个人知识库、隔离的共享团队空间、通过 HTTPS 连接远程 MCP、托管存储、备份和由 Stripe 管理的计费，请使用托管应用。团队工作区包含所有者／管理员／审核者／编辑者／查看者角色、绑定电子邮件的邀请、审计记录、授权席位和 SCIM 配置。使用托管服务需要有效的个人或团队订阅。支持 OAuth 的远程 MCP 客户端可通过浏览器登录，并使用 PKCE 和轮换刷新令牌明确授权访问空间；非交互式客户端仍可使用绑定空间、限定范围且会过期的手动授权。托管的自主空间采用应用层静态加密，但并非零知识，因为授权运行时会在工作时解密这些空间。

公开软件包包含完整的本地优先核心。托管身份验证、Stripe 计费、团队多租户、SSO、SCIM、部署自动化和生产凭据均属于托管服务的一部分，本地运行 NeuraKeep 并不需要这些功能。

CLI 示例

node dist/cli/index.js ingest README.md --root .umos --kind markdown --space personal --trust-level trusted --origin manual --sensitivity internal
node dist/cli/index.js search "what should my agents remember?" --root .umos --space personal --neighbors 1
node dist/cli/index.js propose latest --root .umos
node dist/cli/index.js apply <proposal-id> --root .umos
node dist/cli/index.js mcp --root .umos

本地 MCP 配置

stdio MCP 配置示例：

{
  "command": "node",
  "args": [
    "C:/path/to/neurakeep/dist/cli/index.js",
    "mcp",
    "--root",
    "C:/path/to/neurakeep/.umos"
  ]
}

本地 HTTP 模式：

node dist/cli/index.js serve --root .umos --host 127.0.0.1 --port 8765 --ui

在将任何 HTTP 端点暴露到设备外部之前，请使用 --token 或 NEURAKEEP_MCP_TOKEN。

免费版与付费版

开源版本用于本地、自主管理记忆。托管产品还提供托管身份验证、团队空间、远程连接器、共享存储、备份和管理功能。当前托管方案请参见 NeuraKeep 定价。

文档

• 手动导入
• MCP 集成
• 开源核心
• 公开软件包边界

开发检查

npm run typecheck
npm run build:all
npm test
npm run e2e
npm run check:secrets

许可证

Apache-2.0