适合谁
- 需要持久记忆的 AI 代理（如 Cursor、VS Code Copilot）
- 多代理协作场景
- 追求 token 效率和快速上下文加载的开发者
S
44FMRS · D
Soul 提供了一个强大的持久内存解决方案，通过强制保存和加载确保确定性，减少 token 浪费。其基于文件的云存储方法简单且无供应商锁定。然而，它需要自我管理存储和潜在的同步问题。
Soul 是一个 MCP 服务器，为 AI 智能体提供跨会话的持久内存、交接（handoffs）、不可变工作日志、共享大脑、实体记忆（自动跟踪人物、硬件、项目）和核心记忆（智能体特定的常驻事实）。它基于 SQLite 的 KV-Cache 提供高性能的会话编排，支持渐进式加载（L1/L2/L3）以控制 token 消耗，并采用艾宾浩斯遗忘曲线进行智能垃圾回收。数据存储在纯 JSON 文件中，可通过任何文件夹同步服务（如 Google Drive、NAS）实现零配置云存储。
工具能力
n2_boot
启动序列：加载交接、实体、核心记忆、代理和 KV-Cache。
n2_work_start
注册活跃工作会话。
n2_work_claim
声明文件所有权以防止冲突。
n2_work_log
在工作期间记录文件变更。
n2_work_end
结束会话：写入账本、交接、实体、洞察和 KV-Cache。
n2_brain_read
从共享内存中读取内容。
n2_brain_write
向共享内存写入内容。
n2_entity_upsert
添加/更新实体（自动合并属性）。
n2_entity_search
按关键字或类型搜索实体。
n2_core_read
读取特定于代理的核心记忆。
n2_core_write
写入特定于代理的核心记忆。
n2_context_search
跨大脑和账本搜索。
n2_kv_save
手动保存 KV-Cache 快照。
n2_kv_load
加载最近的快照。
n2_kv_search
按关键字搜索过去的会话。
n2_kv_gc
垃圾回收旧快照。
n2_kv_backup
备份到便携式 SQLite 数据库。
n2_kv_restore
从备份恢复。
n2_kv_backup_list
列出备份历史。
安装接入
- 安装：npm install n2-soul 或从源码克隆并 npm install。
- 在 MCP 配置中添加服务器：script 命令为 node，参数为 n2-soul/index.js 的绝对路径。
- 告诉你的智能体在会话开始时调用 n2_boot，结束时调用 n2_work_end。
- 可选：编辑 lib/config.local.js 以启用 SQLite 后端和 Ollama 嵌入。
claude_desktop_config.json
{
"mcpServers": {
"soul": {
"command": "node",
"args": [
"/path/to/node_modules/n2-soul/index.js"
]
}
}
}
选型与风险
不适合谁
- 不需要跨会话记忆的简单单次会话
- 对数据隐私极其敏感，不希望任何同步的场合
- 需要内置云服务且不想自托管存储的用户
所需权限
- 本地文件系统读写（存储 JSON 配置、快照、账本）
- 可通过配置文件指向远程文件夹（如 Google Drive）
- 可选：访问 Ollama 本地服务进行嵌入
风险与副作用
- 数据以纯文本 JSON 存储，敏感信息未加密
- 多代理并发写入可能导致数据冲突（但文件所有权可减轻）
- 云同步可能因同步冲突导致数据不一致
- 需要 Node.js 18+
常见排障
- 确保 Node.js 版本 >= 18
- 检查 MCP 配置中的路径是否正确
- 确保数据目录可写
- 如果启用嵌入，确保 Ollama 正在运行且模型已拉取
使用场景
跨会话保持 AI 代理上下文，避免重复解释
多代理协作，无缝交接工作
跟踪项目状态、TODO 和工作历史
共享知识库，多个代理读写同一上下文
支持客户端
Claude Desktop完整支持
Cursor完整支持
VS Code Copilot完整支持
Open WebUI完整支持
LM Studio完整支持
Other MCP-compatible hosts完整支持