Simple Memory Extension MCP

简单内存扩展MCP服务器

MCP服务器，用于扩展代理的上下文窗口/内存。在编码大功能或氛围编码时非常有用，需要存储/回忆进度、关键时刻或变化或任何值得记住的事情。只需要求代理在需要时存储记忆并回忆，或者要求代理以它认为合适的方式完全管理其记忆（例如通过光标规则）。

用法

启动服务器

npm install
npm start

MCP设置

  "mcpServers": {
    "simple-memory": {
      "url": "http://localhost:3000/sse",
      "trust": false
    }
  }

可用工具

上下文项目管理

• 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. 返回带有完整项目值的热门匹配项

发展

# Dev server
npm run dev

# Format code
npm run format

.env

# Path to SQLite database file
DB_PATH=./data/context.db

PORT=3000

# Use HTTP SSE or Stdio
USE_HTTP_SSE=true

# Logging Configuration: debug, info, warn, error
LOG_LEVEL=info

语义搜索

该项目包括使用Hugging Face的E5嵌入模型的语义搜索功能。这允许您根据上下文项的含义而不仅仅是精确的键匹配来查找上下文项。

设置

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

嵌入模型

我们使用 intfloat/多语言e5-large结构

备注

主要是在vibe编码时开发的，所以不要期望太多：D.但它确实有效，我发现它很有帮助，所以请随时贡献或提出改进建议。