← 返回目录

Soul

社区

为多智能体系统提供持久内存层，让AI永不遗忘。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他第 187 / 230
Stars: ★ 67 热门
传输方式: stdio（本地进程）
运行环境: Node.js 18+
凭据: 无需凭据
许可证: 其他 / 未声明
最近提交: 6 个月前 ⚠
工具数: 19

44FMRS · D

Soul 提供了一个强大的持久内存解决方案，通过强制保存和加载确保确定性，减少 token 浪费。其基于文件的云存储方法简单且无供应商锁定。然而，它需要自我管理存储和潜在的同步问题。

最强项 · 文档质量 13/20 最弱项 · 可靠性 5/20

可靠性

5/20

安全与权限

8/20

维护活跃度

7/20

文档质量

13/20

安装易用性

11/20

查看各项评分依据

可靠性 5/20: 仅从README和源码树无法确认服务器能干净启动并完成MCP握手；没有提供CI工作流或测试运行的证据。声明有20多个工具，但未提供每个工具的参数和行为的代码级验证。错误处理和依赖控制的信息不足，因此可靠性得分低。
安全与权限 8/20: 未发现恶意代码或凭证窃取迹象；数据存储为本地JSON/SQLite，不支持远程命令执行。但权限模型不明确，文件操作如文件所有权可能存在问题，缺少对危险操作的明确确认机制。
维护活跃度 7/20: 仓库有新版本（v9.0）和活跃的提交记录，但开源问题数为0，没有明确的安全响应渠道。许可证在GitHub上标注为NOASSERTION，但README声称Apache-2.0。依赖更新频率不明。
文档质量 13/20: README非常详细，包含快速开始、工具列表、配置和数据目录结构，以及云存储和团队共享示例。但缺少故障排查部分，没有每个工具的完整参数和错误场景说明。文档中关于许可证的声明与GitHub元数据不一致。
安装易用性 11/20: 安装步骤清晰（npm或源码），提供了多种客户端的配置示例（Cursor、Claude Desktop、Open WebUI等），但需要Node.js 18+。从源码运行时需要绝对路径，可能有平台差异。静态审查未提供运行时验证，因此安装流程未被验证。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件连接数据库

适合谁

需要持久记忆的 AI 代理（如 Cursor、VS Code Copilot）
多代理协作场景
追求 token 效率和快速上下文加载的开发者

不适合谁

不需要跨会话记忆的简单单次会话
对数据隐私极其敏感，不希望任何同步的场合
需要内置云服务且不想自托管存储的用户

所需权限

本地文件系统读写（存储 JSON 配置、快照、账本）
可通过配置文件指向远程文件夹（如 Google Drive）
可选：访问 Ollama 本地服务进行嵌入

风险与副作用

数据以纯文本 JSON 存储，敏感信息未加密
多代理并发写入可能导致数据冲突（但文件所有权可减轻）
云同步可能因同步冲突导致数据不一致
需要 Node.js 18+

安装接入

准备工作

运行环境：Node.js 18+

安装：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"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "soul": {
      "command": "node",
      "args": [
        "/path/to/node_modules/n2-soul/index.js"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add soul -- node /path/to/node_modules/n2-soul/index.js

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 MCP 客户端的工具列表中确认出现 n2_boot、n2_work_end 等以 n2_ 开头的工具；然后调用 n2_boot(rose, my-app)，若返回“无历史上下文/全新开始”即说明服务器已正常运行。

常见排障

确保 Node.js 版本 >= 18
检查 MCP 配置中的路径是否正确
确保数据目录可写
如果启用嵌入，确保 Ollama 正在运行且模型已拉取

试试这样问

连接成功后，可以直接对 AI 助手这样说：

用 n2_boot 以 agent 名 rose 和项目 my-app 启动会话，加载上次的上下文
把“数据库使用 SQLite 后端”这条事实写入我的核心记忆（n2_core_write）
用 n2_entity_search 搜索之前记录过的所有 service 类型的实体
搜索过去会话中关于 auth 模块的关键词记录（n2_kv_search）

工具能力 19

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 写入

添加/更新实体（自动合并属性）。

展开其余 11 个工具

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 只读

列出备份历史。

使用场景

跨会话保持 AI 代理上下文，避免重复解释

多代理协作，无缝交接工作

跟踪项目状态、TODO 和工作历史

共享知识库，多个代理读写同一上下文

支持客户端

Claude Desktop

Cursor

VS Code

Open WebUI

LM Studio

Other MCP-compatible hosts

依据项目文档列出，未经本站实测。

详细介绍

Soul 是一个 MCP 服务器，为 AI 智能体提供跨会话的持久内存、交接（handoffs）、不可变工作日志、共享大脑、实体记忆（自动跟踪人物、硬件、项目）和核心记忆（智能体特定的常驻事实）。它基于 SQLite 的 KV-Cache 提供高性能的会话编排，支持渐进式加载（L1/L2/L3）以控制 token 消耗，并采用艾宾浩斯遗忘曲线进行智能垃圾回收。数据存储在纯 JSON 文件中，可通过任何文件夹同步服务（如 Google Drive、NAS）实现零配置云存储。