SuperAPI AI 工具集

memory-mcp

memory-mcp 是一个简易的 MCP(模型上下文协议)服务器,用于为多个 LLM 对话提供持久化记忆与上下文窗口缓存,底层采用 MongoDB 存储。它适用于 Cursor、Claude Desktop 等 AI 编程环境,可保存、检索和管理记忆,支持标签化搜索、相关性评分,并在上下文使用率达到 80% 时自动归档、降到 30% 以下时自动检索相关内容。

访问官网

工具介绍

用途

memory-mcp 是一个遵循 MCP(Model Context Protocol)协议的服务器,为 AI 编程环境(如 Cursor、Claude Desktop)提供持久化记忆与上下文窗口缓存能力,用于保存、检索和管理 LLM 对话记忆,底层由 MongoDB 提供存储支持。

主要能力

  • 持久存储:基于 MongoDB 的记忆存储,可跨会话保留。
  • 上下文缓存:智能归档和检索对话上下文。
  • 标签搜索:按标签组织和查找记忆。
  • 相关性评分:自动为归档内容进行相关性评分。
  • 便捷安装:支持在 Cursor 中一键安装,或手动配置。

基础记忆工具包括:

  • save-memories:保存记忆到数据库(覆盖已有内容)
  • get-memories:检索所有已存记忆
  • add-memories:追加新记忆而不覆盖
  • clear-memories:移除所有已存记忆

上下文窗口缓存工具包括:

  • archive-context:带标签归档对话上下文
  • retrieve-context:检索相关的已归档上下文
  • score-relevance:对归档内容进行相关性评分
  • create-summary:为归档内容创建摘要
  • get-conversation-summaries:获取某对话的所有摘要
  • search-context-by-tags:按标签搜索归档内容

使用方式

安装:推荐在 Cursor 中一键安装,或手动安装。

手动安装要求:Node.js 18+、npm、MongoDB。

Claude Desktop 配置:将相应配置加入 claude_desktop_config.json。 macOS 路径:~/Library/Application Support/Claude/claude_desktop_config.json Windows 路径:%APPDATA%\Claude\claude_desktop_config.json 配置后需重启 Claude Desktop。

设置 MongoDB 连接字符串:默认 mongodb://localhost:27017

典型操作示例:

  • 从对话存储记忆
  • 检索记忆:获取所有已存记忆
  • 归档上下文:当对话过长时归档
  • 检索相关上下文:获取与当前对话相关的已归档内容

系统自动化行为:

  • 当上下文使用率达到 80% 时自动归档内容
  • 当使用率降到 30% 以下时自动检索相关内容
  • 使用关键词重叠进行相关性评分
  • 创建摘要以压缩长对话

适用场景

  • 长对话:管理扩展会话的上下文窗口
  • 记忆持久化:跨会话保存重要信息
  • 上下文检索:找回相关的过往对话
  • 研究项目:组织和标记研究对话

限制

  • 需要自行准备并运行 MongoDB。
  • 需 Node.js 18+ 与 npm 环境。
  • 具体定价、收费模式暂未提供。

技术细节

  • 技术栈:Node.js、TypeScript、MCP SDK、MongoDB
  • 依赖:@modelcontextprotocol/sdk、mongodb、zod
  • 平台:macOS、Windows、Linux
  • 存储:MongoDB(默认 mongodb://localhost:27017)