Simple Memory Extension MCP Server

基本能力

产品定位

Simple Memory Extension MCP Server 旨在通过扩展代理的上下文窗口或内存，帮助用户在复杂任务中更好地管理和回忆关键信息。

核心功能

1. 上下文项管理：存储、检索和删除键值对。
2. 命名空间管理：创建、删除命名空间，以及列出命名空间和其中的键。
3. 语义搜索：基于E5模型实现语义搜索，允许用户通过含义而非精确匹配查找内容。

适用场景

• 编写大型功能时需要存储和回忆进度。
• 创意编码（vibe coding）时记录关键变化或灵感。
• 需要代理自动管理其内存的场景。

工具列表

1. Context Item Management
2. store_context_item：在命名空间中存储键值对。
3. retrieve_context_item_by_key：通过键检索值。
4. delete_context_item：删除键值对。
5. Namespace Management
6. create_namespace：创建新命名空间。
7. delete_namespace：删除命名空间及其所有内容。
8. list_namespaces：列出所有命名空间。
9. list_context_item_keys：列出命名空间中的键。
10. Semantic Search
11. retrieve_context_items_by_semantic_search：通过语义搜索查找内容。

常见问题解答

• 语义搜索如何工作？ 查询通过E5模型转换为向量，文本自动分块以便更好匹配，计算查询与存储块之间的余弦相似度，结果按相似度排序并返回顶部匹配。
• 如何设置语义搜索？ 运行npm run start时，Python依赖项会自动安装。

使用教程

使用依赖

1. 确保已安装Node.js和npm。
2. 安装Python依赖（语义搜索功能需要）。

安装教程

1. 克隆项目并进入项目目录。
2. 运行以下命令： bash npm install npm start

调试方式

1. 开发服务器： bash npm run dev
2. 代码格式化： bash npm run format

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。