AI导哈

智能语义记忆服务

为AI代理提供持久化语义记忆存储与检索的本地化工具，支持TF-IDF相似性搜索和主动建议功能。

  • by christian140903-sudo
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 christian140903-sudo/smart-memory-mcp

使用说明

智能内存MCP

具有语义搜索的AI代理的持久记忆。

你的AI代理在会话之间会忘记一切。Smart Memory解决了这个问题。

适用于 克劳德代码, 光标, 帆板运动，以及任何兼容MCP的客户端。

特性

  • 语义搜索 --TF-IDF相似性匹配，而不仅仅是关键字
  • 零配置 --安装后，它就可以工作了。没有云，没有API密钥
  • 100%本地 --所有数据都以JSON文件的形式保存在您的计算机上
  • 双语 --英语和德语支持
  • 近期增长 --最近的知识排名更高
  • 有用性评分 --对条目进行评分，以提高未来的召回率

快速开始

克劳德代码

claude mcp add memory -- npx mcp-smart-memory

Cursor/Windsurf/其他MCP客户端

添加到MCP配置中：

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["mcp-smart-memory"]
    }
  }
}

就是这样。你的特工现在有持久记忆了。

工具

工具 说明
memory_learn 用类别和标签存储知识
memory_recall 使用TF-IDF语义相似度进行搜索
memory_stats 知识库统计和概述
memory_patterns 分析模式、标签频率、共现
memory_suggest 基于当前背景的主动建议
memory_evaluate 将条目评为有用/无用，以便更好地回忆

用法示例

储存知识

memory_learn: "React useEffect cleanup runs before component unmount and before re-running the effect"
  category: "pattern"
  tags: ["react", "hooks", "cleanup"]

回忆知识

memory_recall: "how to clean up effects in React"
→ Returns semantically similar entries ranked by relevance

获取建议

memory_suggest: "I'm debugging a memory leak in a React component"
→ Returns relevant warnings, solutions, and best practices from your knowledge base

配置

环境变量 默认值 描述
SMART_MEMORY_DIR ~/.smart-memory 数据存储目录
SMART_MEMORY_DB default 数据库名称（适用于多个知识库）

多个知识库

{
  "mcpServers": {
    "work-memory": {
      "command": "npx",
      "args": ["mcp-smart-memory"],
      "env": { "SMART_MEMORY_DB": "work" }
    },
    "personal-memory": {
      "command": "npx",
      "args": ["mcp-smart-memory"],
      "env": { "SMART_MEMORY_DB": "personal" }
    }
  }
}

运作原理

智能内存使用 TF-IDF（词频反转文档频率） 语义搜索的余弦相似性——用纯JavaScript实现，零ML依赖。

当你储存知识时：

  1. 文本被标记，停用词被删除
  2. 为快速查找而构建倒排索引
  3. 计算TF-IDF向量以进行相似性匹配

搜索时：

  1. 您的查询使用相同的TF-IDF管道进行矢量化
  2. 对所有条目计算余弦相似度
  3. 结果受到时效性和有用性评级的推动
  4. 返回热门匹配项，按相关性得分排名

数据存储

所有数据都以JSON文件的形式存储在本地：

~/.smart-memory/
  └── default/
      ├── knowledge.json    # Your knowledge entries
      └── index.json        # TF-IDF search index

文件是人类可读和可移植的。备份、共享或版本控制它们。

为什么选择智能内存？

智能内存 claude mem mem0 Zep
MCP本地 ✅ ❌ 插件 ❌ SDK ❌ SDK
任何MCP客户端 ✅ ❌ 只有克劳德❌ 仅限Python❌ 仅限Python
无云 ✅ ✅ ❌ ❌
没有API密钥 ✅ ✅ ❌ ❌
语义搜索 ✅ TF-IDF ❌ 基础 ✅ 嵌入 ✅ 嵌入件
模式检测 ✅ ❌ ❌ ❌
主动建议 ✅ ❌ ❌ ❌

构建于

建造于 NexTool --由Claude Opus 4.6支持的人工智能原生开发工作室。

许可证

麻省理工学院

相关 MCP