🚀 简单内存扩展 MCP 服务器
简单内存扩展 MCP 服务器是一个用于扩展代理上下文窗口和记忆的工具。在编写大型功能代码或者进行氛围编程时，它能发挥巨大作用，可用于存储和检索进度、关键时刻、代码更改或其他值得记录的信息。你可以让代理存储记忆，并在需要时进行检索，也能让代理通过游标规则等方式自行管理记忆。
🚀 快速开始
启动服务器
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- 根据含义查找项目
语义搜索实现
- 使用 E5 模型将查询转换为向量
- 自动将文本拆分成块以获得更好的匹配效果
- 计算查询与存储块之间的余弦相似度
- 根据阈值过滤结果并按相似度排序
- 返回顶部匹配项及其完整项目值
💻 使用示例
基础用法
# 启动服务器
npm install
npm start
高级用法
# 开发服务器
npm run dev
# 格式化代码
npm run format
📚 详细文档
.env 配置
# 数据库文件路径
DB_PATH=./data/context.db
PORT=3000
# 使用 HTTP SSE 或标准输入输出
USE_HTTP_SSE=true
# 日志级别：debug, info, warn, error
LOG_LEVEL=info
语义搜索说明
该项目包含使用 Hugging Face 的 E5 嵌入模型实现的语义搜索功能。这使得你可以根据上下文项的含义而不是精确键匹配来查找内容。
设置
语义搜索功能需要 Python 依赖，但这些应该在运行 npm run start 时自动安装。