简易记忆扩展 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 - 通过含义查找项目

语义搜索实现

1. 查询使用 E5 模型转换为向量
2. 文本自动分割成块，以获得更好的匹配
3. 计算查询和存储的块之间的余弦相似度
4. 结果按阈值过滤并按相似度排序
5. 返回具有完整项目值的最佳匹配

开发

# 开发服务器
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

备注

主要是在氛围编码时开发的，所以不要期望太多 :D。但它有效，而且我发现它很有帮助，所以就这样吧。欢迎贡献或提出改进建议。