适合谁
- 需要离线、低延迟和本地数据存储的 AI 智能体。
- 希望避免记忆存储和检索阶段大模型调用的开发者。
- 需要持久化记忆、知识图谱或 Hebbian 学习机制的项目。
- 使用 Zenoh、ROS2 或机器人任务记忆的团队。
S
59FMRS · C
资料显示这是一个 Apache-2.0 授权、版本 0.2.0、通过 stdio 提供 MCP 接口的本地认知记忆服务器。其主要特点是无需大模型调用、支持语义搜索和知识图谱，并覆盖记忆、会话、任务、项目、提醒、统计与备份管理。
Shodh-Memory 为 AI 智能体和机器人提供持久化认知记忆。它使用本地算法完成语义搜索、Hebbian 学习、记忆衰减、知识图谱、因果追踪和相关记忆激活，不需要云服务、外部数据库或存储和检索阶段的大模型调用。服务器通过 stdio MCP 传输运行，后端默认地址为 http://127.0.0.1:3030。
工具能力
remember
保存一条记忆。
recall
按语义搜索记忆。
recall_by_tags
按标签搜索记忆。
proactive_context
获取与当前上下文相关的主动记忆提示。
context_summary
生成记忆上下文摘要。
list_memories
列出记忆。
read_memory
读取指定记忆。
forget
删除或遗忘指定记忆。
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
清理备份。
安装接入
确保本地 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。
claude_desktop_config.json
{"mcpServers":{"shodh-memory":{"command":"npx","args":["-y","@shodh/memory-mcp"]}}}
选型与风险
不适合谁
- 需要托管云端记忆服务或内置多租户授权的用户。
- 希望服务器本身负责大模型推理的应用。
- 需要在没有本地后端的情况下直接使用 MCP 客户端的场景。
- 仅需要简单无状态文本处理的工作流。
所需权限
- 需要访问并写入 Shodh-Memory 的本地记忆数据。
- 需要通过 stdio 启动 npm 包及其本地 MCP 服务器。
- 若连接远程后端，需要访问 SHODH_API_URL 指定的地址。
- 若启用认证，需要提供 SHODH_API_KEY；该变量是秘密值。
- 工具可创建、修改、删除记忆、待办、项目、提醒和备份。
风险与副作用
- 记忆、待办、项目和备份可能包含敏感信息，并会持久保存在本地后端。
- forget、delete、purge 和 backup_restore 等工具可能造成数据丢失或覆盖。
- 远程部署时，API 密钥和网络暴露需要由部署者自行保护。
- SHODH_USER_ID 是逻辑记忆命名空间，不是授权租户。
- 本地模型会在首次运行时下载；其运行依赖本机资源和模型文件。
常见排障
- 确认 Shodh-Memory 后端正在运行，并监听默认的 http://127.0.0.1:3030。
- 检查 SHODH_API_URL 是否指向正确的后端地址。
- 远程后端需要检查 SHODH_API_KEY 是否已设置且有效。
- 确认 npx 可用，并使用 npx -y @shodh/memory-mcp 启动服务器。
- 使用 shodh status 或 shodh doctor 检查后端健康状态。
- 若索引异常，可检查 verify_index、repair_index 和 memory_health。
使用场景
为 Claude Code、Claude Desktop 或 Cursor 保存跨会话记忆。
在本地进行语义搜索、标签搜索和知识图谱查询。
管理智能体的待办事项、项目、提醒和会话摘要。
为机器人和边缘设备保存任务、传感器与任务结果记忆。
支持客户端
Claude Code完整支持
Claude Desktop完整支持
Cursor完整支持