Simple Memory Extension

🚀 简单内存扩展 MCP 服务器

简单内存扩展 MCP 服务器用于扩展代理上下文窗口和记忆。在开发大型功能或进行 vibe 编码时，它能帮助存储和召回进度、关键时刻、更改等重要内容。你可以让代理存储记忆、随时召回，也能让代理通过游标规则等自主管理记忆。

🚀 快速开始

启动服务器

npm install
npm start

✨ 主要特性

可用工具

上下文项管理

• store_context_item - 在命名空间中存储值和键
• retrieve_context_item_by_key - 根据键获取值
• delete_context_item - 删除键值对

命名空间管理

• create_namespace - 创建新命名空间
• delete_namespace - 删除命名空间及其所有内容
• list_namespaces - 列出所有命名空间
• list_context_item_keys - 在命名空间中列出键

语义搜索

• retrieve_context_items_by_semantic_search - 根据意义查找项

语义搜索实现

1. 使用 E5 模型将查询转换为向量
2. 自动将文本拆分为段落以提高匹配效果
3. 计算查询与存储段落之间的余弦相似度
4. 根据阈值过滤结果并按相似度排序
5. 返回 top 匹配项及其完整值

💻 使用示例

基础用法

# 启动服务器
npm install
npm start

高级用法

# 开发服务器
npm run dev

# 格式化代码
npm run format

📚 详细文档

.env 配置

# SQLite 数据库文件路径
DB_PATH=./data/context.db

PORT=3000

# 使用 HTTP SSE 或 Stdio
USE_HTTP_SSE=true

# 日志配置：debug, info, warn, error
LOG_LEVEL=info

语义搜索

该项目包含使用 Hugging Face 的 E5 嵌入模型的语义搜索功能。这使你可以根据项的意义而不是仅通过键来查找上下文项。

设置

语义搜索功能需要 Python 依赖，但这些应该在运行 npm run start 时自动安装。

嵌入模型

我们使用的是 intfloat/multilingual-e5-large-instruct

备注

此项目主要是在 vibe 编码过程中开发的，所以不要期望太多 :D。但它确实有效，我觉得它很有用，随意贡献或提供建议。