M
MCP 精选目录 CURATED DIRECTORY
已收录 911 个 MCP Server
EN
← 返回目录
S

Shodh-Memory MCP Server

官方
无需大模型、完全本地运行的认知记忆 MCP 服务器。
查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗
分类
数据库 第 20 / 58
Stars
★ 306 非常热门
传输方式
stdio（本地进程）
运行环境
Node.js · 预编译二进制
凭据
无需凭据
许可证
Apache-2.0
最近提交
工具数
51
59FMRS · C

资料显示这是一个 Apache-2.0 授权、版本 0.2.0、通过 stdio 提供 MCP 接口的本地认知记忆服务器。其主要特点是无需大模型调用、支持语义搜索和知识图谱，并覆盖记忆、会话、任务、项目、提醒、统计与备份管理。

最强项 · 文档质量 14/20 最弱项 · 可靠性 9/20

可靠性
9/20
安全与权限
11/20
维护活跃度
12/20
文档质量
14/20
安装易用性
13/20
查看各项评分依据
可靠性 9/20
清单声明了 npm stdio 包、版本和默认本地后端，README 也描述了 MCP 工具与 API 路径，因此正常启动流程具有一定可信度。但本次仅有静态材料，未提供实际初始化握手、工具列表响应、提交的测试或关键路径覆盖证据；后端自动下载、IPC/HTTP 回退及 51 个工具的真实匹配关系无法验证，因此扣分，且按静态校准不超过 12 分。
安全与权限 11/20
默认 API 地址为 127.0.0.1，API 密钥被标记为 secret，文档说明 API 端点需要 X-API-Key，并提供本地绑定、CORS、IPC 和生产环境配置，显示出基本的数据边界意识。扣分原因是 user_id 明确不是授权租户，远程 Zenoh 示例监听 0.0.0.0，且多个删除、清除、恢复和重置工具没有展示确认、权限分级或误操作保护；对外部网络、自动模型下载和数据流的完整披露也不足。未发现足以触发红线的证据。
维护活跃度 12/20
仓库未归档，提供 Apache-2.0 许可证、明确的 GitHub 所有者、0.2.0 版本以及 npm/crates/PyPI 等发布渠道；README 还展示了 CI 徽章。扣分原因是没有提供实际提交历史、CI 工作流、依赖更新记录、漏洞响应流程或维护承诺，开放问题数量也不能证明响应质量；因此只能评为有维护迹象而非持续治理充分。
文档质量 14/20
README 覆盖安装、客户端配置、认证环境变量、平台、部署模式、工具分类、API 示例、性能声明和故障诊断命令，信息量较高。扣分原因是没有逐工具参数和返回模式、错误语义、数据保留/隐私限制、备份恢复风险或可复核的测试证据；“无需 API key”与远程认证、自动生成密钥等表述也存在需要澄清的边界。
安装易用性 13/20
提供 npx -y @shodh/memory-mcp 的 Claude Code 和 JSON 客户端配置，步骤较少，并列出 Linux、macOS、Windows 平台及 Docker/Python 等路径。扣分原因是 MCP 客户端仍依赖可自动下载或预先运行的后端，IPC 与 HTTP 选择规则较复杂，远程部署需要额外认证和代理配置；没有提交的端到端安装或连接验证证据，因此不能给出高于静态上限的分数。

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

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络连接数据库

适合谁

  • 需要离线、低延迟和本地数据存储的 AI 智能体。
  • 希望避免记忆存储和检索阶段大模型调用的开发者。
  • 需要持久化记忆、知识图谱或 Hebbian 学习机制的项目。
  • 使用 Zenoh、ROS2 或机器人任务记忆的团队。

不适合谁

  • 需要托管云端记忆服务或内置多租户授权的用户。
  • 希望服务器本身负责大模型推理的应用。
  • 需要在没有本地后端的情况下直接使用 MCP 客户端的场景。
  • 仅需要简单无状态文本处理的工作流。

所需权限

  • 需要访问并写入 Shodh-Memory 的本地记忆数据。
  • 需要通过 stdio 启动 npm 包及其本地 MCP 服务器。
  • 若连接远程后端，需要访问 SHODH_API_URL 指定的地址。
  • 若启用认证，需要提供 SHODH_API_KEY；该变量是秘密值。
  • 工具可创建、修改、删除记忆、待办、项目、提醒和备份。

风险与副作用

  • 记忆、待办、项目和备份可能包含敏感信息，并会持久保存在本地后端。
  • forget、delete、purge 和 backup_restore 等工具可能造成数据丢失或覆盖。
  • 远程部署时，API 密钥和网络暴露需要由部署者自行保护。
  • SHODH_USER_ID 是逻辑记忆命名空间，不是授权租户。
  • 本地模型会在首次运行时下载；其运行依赖本机资源和模型文件。

安装接入

准备工作

运行环境：Node.js · 预编译二进制

SHODH_API_KEY 可选密钥 访问后端的 API 密钥；本地使用会自动生成，仅连接远程服务器时需要。
SHODH_API_KEYS 可选密钥 生产模式下逗号分隔的 API 密钥列表，由管理员自行生成。
其他可选配置项（19 个）
SHODH_API_URL 可选 shodh-memory 后端服务器地址，默认 http://127.0.0.1:3030，本地运行无需设置。
SHODH_USER_ID 可选 逻辑记忆命名空间，默认 "default"，不是授权租户。
SHODH_ENV 可选 设为 production 启用生产模式。
SHODH_HOST 可选 服务器绑定地址，默认 127.0.0.1。
SHODH_PORT 可选 服务器端口，默认 3030。
SHODH_MEMORY_PATH 可选 数据存储目录，例如 /var/lib/shodh。
SHODH_IPC_ENABLED 可选 默认启用本地 IPC，设为 false 可禁用。
SHODH_IPC_ENDPOINT 可选 平台特定的 IPC 套接字路径覆盖。
SHODH_IPC_REQUIRED 可选 设为 true 时 IPC 失败将直接报错而非回退到 HTTP。
SHODH_REQUEST_TIMEOUT 可选 请求超时秒数，默认 60。
SHODH_MAX_CONCURRENT 可选 最大并发请求数，默认 200。
SHODH_ROCKSDB_BLOCK_CACHE_MB 可选 RocksDB 共享块缓存大小（MiB），默认 256。
SHODH_CORS_ORIGINS 可选 允许的 CORS 来源，例如 https://app.example.com。
SHODH_ZENOH_ENABLED 可选 设为 true 启用 Zenoh 机器人传输。
SHODH_ZENOH_MODE 可选 Zenoh 模式：peer、client 或 router。
SHODH_ZENOH_LISTEN 可选 Zenoh 监听端点，如 tcp/0.0.0.0:7447。
SHODH_ZENOH_CONNECT 可选 Zenoh 连接端点，如 tcp/1.2.3.4:7447。
SHODH_ZENOH_PREFIX 可选 Zenoh 键表达式前缀，默认 shodh。
SHODH_ZENOH_AUTO_TOPICS 可选 JSON 数组，配置经 zenoh-bridge-ros2dds 自动订阅的 ROS2 主题。

确保本地 Shodh-Memory 后端运行在默认地址 http://127.0.0.1:3030，然后将服务器加入客户端：claude mcp add shodh-memory -- npx -y @shodh/memory-mcp。Claude Desktop 或 Cursor 可使用提供的 MCP 配置。远程后端可通过 SHODH_API_URL 配置，并按需设置 SHODH_API_KEY；SHODH_USER_ID 默认为 default。

.mcp.json 
{"mcpServers":{"shodh-memory":{"command":"npx","args":["-y","@shodh/memory-mcp"]}}}

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

.vscode/mcp.json
{
  "servers": {
    "shodh-memory": {
      "command": "npx",
      "args": [
        "-y",
        "@shodh/memory-mcp"
      ]
    }
  }
}

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

Terminal
claude mcp add shodh-memory -- npx -y @shodh/memory-mcp

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

生成并校验客户端配置

验证是否装好

在 Claude Code 中运行 claude mcp add shodh-memory -- npx -y @shodh/memory-mcp 后，工具列表中应出现 remember、recall 等 shodh-memory 工具；然后让助手记住一条偏好并问回它，若能答出则说明连接成功。

常见排障

  1. 确认 Shodh-Memory 后端正在运行，并监听默认的 http://127.0.0.1:3030。
  2. 检查 SHODH_API_URL 是否指向正确的后端地址。
  3. 远程后端需要检查 SHODH_API_KEY 是否已设置且有效。
  4. 确认 npx 可用，并使用 npx -y @shodh/memory-mcp 启动服务器。
  5. 使用 shodh status 或 shodh doctor 检查后端健康状态。
  6. 若索引异常，可检查 verify_index、repair_index 和 memory_health。

试试这样问

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

  • 记住我喜欢深色模式，这是一个决定
  • 回忆一下之前你记录的关于用户偏好的内容
  • 列出我当前所有的待办事项
  • 给我看这周的会话摘要

工具能力 51

remember 写入
保存一条记忆。
recall 只读
按语义搜索记忆。
recall_by_tags 只读
按标签搜索记忆。
proactive_context 只读
获取与当前上下文相关的主动记忆提示。
context_summary 只读
生成记忆上下文摘要。
list_memories 只读
列出记忆。
read_memory 只读
读取指定记忆。
forget 破坏性
删除或遗忘指定记忆。
展开其余 43 个工具
quick_recall 只读
快速检索记忆。
query 只读
查询记忆和相关知识。
topic 只读
检索某个主题的记忆。
what_i_know 只读
查询系统已知的信息。
recent_memories 只读
列出最近的记忆。
pending_work 只读
查询待处理工作。
count 只读
统计记忆数量。
memory_health 只读
检查记忆系统健康状况。
session_summary 只读
获取会话摘要。
session_digest 只读
生成会话摘要记录。
session_history 只读
查询会话历史。
fact_narratives 只读
获取事实叙述。
purge_facts 破坏性
清理事实记录。
add_todo 写入
添加待办事项。
list_todos 只读
列出待办事项。
update_todo 写入
更新待办事项。
complete_todo 写入
完成待办事项。
delete_todo 破坏性
删除待办事项。
reorder_todo 写入
调整待办事项顺序。
list_subtasks 只读
列出子任务。
add_todo_comment 写入
为待办事项添加评论。
list_todo_comments 只读
列出待办事项评论。
update_todo_comment 写入
更新待办事项评论。
delete_todo_comment 破坏性
删除待办事项评论。
todo_stats 只读
获取待办事项统计信息。
add_project 写入
添加项目。
list_projects 只读
列出项目。
archive_project 写入
归档项目。
delete_project 破坏性
删除项目。
set_reminder 写入
设置提醒。
list_reminders 只读
列出提醒。
dismiss_reminder 写入
关闭提醒。
memory_stats 只读
获取记忆系统统计信息。
verify_index 只读
验证索引。
repair_index 写入
修复索引。
token_status 只读
查询令牌状态。
reset_token_session 写入
重置令牌会话。
consolidation_report 只读
获取记忆整合报告。
backup_create 写入
创建备份。
backup_list 只读
列出备份。
backup_verify 只读
验证备份。
backup_restore 写入
恢复备份。
backup_purge 破坏性
清理备份。

使用场景

为 Claude Code、Claude Desktop 或 Cursor 保存跨会话记忆。
在本地进行语义搜索、标签搜索和知识图谱查询。
管理智能体的待办事项、项目、提醒和会话摘要。
为机器人和边缘设备保存任务、传感器与任务结果记忆。

支持客户端

Claude Code
Claude Desktop
Cursor

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

详细介绍

Shodh-Memory 为 AI 智能体和机器人提供持久化认知记忆。它使用本地算法完成语义搜索、Hebbian 学习、记忆衰减、知识图谱、因果追踪和相关记忆激活，不需要云服务、外部数据库或存储和检索阶段的大模型调用。服务器通过 stdio MCP 传输运行，后端默认地址为 http://127.0.0.1:3030。

同类可选方案

与其他 MCP 横向对比

源版本 902daf8394e7 数据同步于 2026-10-11 查看 FMRS 评分方法