mem0 Memory System

@pinkpixel/mem0-mcp MCP 服务器 ✨

模型上下文协议 (MCP) 服务器与Mem0.ai集成，为 LLM 提供持久内存功能。它允许 AI 代理跨会话存储和检索信息。

该服务器使用mem0ai Node.js SDK 作为其核心功能。

特点🧠

工具

• add_memory ：将一段文本内容存储为与特定userId关联的记忆。
  • 输入： content （字符串，必需）、 userId （字符串，必需）、 sessionId （字符串，可选）、 agentId （字符串，可选）、 metadata （对象，可选）
  • 存储提供的文本，以便在将来的交互中回忆。
• search_memory ：根据特定userId的自然语言查询搜索存储的记忆。
  • 输入： query （字符串，必需）、 userId （字符串，必需）、 sessionId （字符串，可选）、 agentId （字符串，可选）、 filters （对象，可选）、 threshold （数字，可选）
  • 根据语义相似性检索相关记忆。
• delete_memory ：根据 ID 从存储中删除特定内存。
  • 输入： memoryId （字符串，必需）、 userId （字符串，必需）、 sessionId （字符串，可选）、 agentId （字符串，可选）
  • 永久删除指定的内存。
  • 根据语义相似性检索相关记忆。

先决条件🔑

该服务器支持两种存储模式：

1. 云存储模式☁️（推荐）
   • 需要Mem0 API 密钥（作为MEM0_API_KEY环境变量提供）
   • 记忆永久存储在 Mem0 的云服务器上
   • 无需本地数据库
2. 本地存储模式💾
   • 需要OpenAI API 密钥（作为OPENAI_API_KEY环境变量提供）
   • 记忆存储在内存向量数据库中（默认情况下是非持久性的）
   • 除非配置为持久存储，否则服务器重启时数据会丢失

安装和配置⚙️

您可以通过两种主要方式运行此服务器：

1. 使用npx （推荐快速使用）

使用 npm 全局安装包：

配置您的 MCP 客户端（例如，Claude Desktop、Cursor、Cline、Roo Code 等）以使用npx运行服务器：

云存储配置（推荐）

**注意：**将"YOUR_MEM0_API_KEY_HERE"替换为您的实际 Mem0 API 密钥。

本地存储配置（替代）

**注意：**用您的实际 OpenAI API 密钥替换"YOUR_OPENAI_API_KEY_HERE" 。

2. 从克隆的存储库运行

注意：此方法要求您先 git clone 存储库。

克隆存储库、安装依赖项并构建服务器：

然后，配置您的 MCP 客户端以使用node直接运行构建的脚本：

重要提示：

1. 将/absolute/path/to/mem0-mcp/替换为克隆存储库的实际绝对路径
2. 使用build/index.js文件，而不是src/index.ts文件
3. MCP 服务器需要干净的标准输出来进行协议通信 - 任何写入标准输出的库或代码都可能干扰协议

默认用户 ID（可选后备）

add_memory和search_memory工具都需要一个userId参数来将记忆与特定用户关联。

为了方便测试或单用户场景，您可以在启动服务器时选择性地设置DEFAULT_USER_ID环境变量。如果设置了此变量，并且在调用search_memory工具时省略了userId参数，则服务器将使用DEFAULT_USER_ID的值进行搜索。

**注意：**虽然存在此后备方案，但通常建议调用代理（LLM）明确提供正确的userId以添加和搜索记忆，以避免歧义。

使用DEFAULT_USER_ID的示例配置：

或者直接使用node运行时：

云存储 vs. 本地存储

云存储（Mem0 API）

• 默认持久化- 您的记忆在会话和服务器重启后仍然可用
• 无需本地数据库- 所有数据都存储在 Mem0 的服务器上
• 更高的检索质量- 使用 Mem0 优化的搜索算法
• 附加字段- 支持agent_id和threshold参数
• 需要- Mem0 API 密钥

本地存储（OpenAI API）

• 默认内存存储- 数据仅存储在 RAM 中，不会长期持久化。虽然可能会进行一些缓存，但不应将其用作永久存储。
• 数据丢失风险——服务器重启、系统重启或进程终止时，内存数据将丢失
• 推荐用于- 仅限开发、测试或临时使用
• 对于持久存储- 如果您需要可靠的长期内存，请使用带有 Mem0 API 的云存储选项
• 使用 OpenAI 嵌入- 用于向量搜索功能
• 自包含- 所有数据都保留在您的机器上
• 需要- OpenAI API 密钥

发展💻

克隆存储库并安装依赖项：

构建服务器：

对于文件更改时自动重建的开发：

调试🐞

由于 MCP 服务器通过 stdio 进行通信，因此调试起来可能比较困难。以下是一些方法：

1. 使用 MCP Inspector ：此工具可以监控 MCP 协议通信：

2. 控制台日志：添加控制台日志时，请始终使用console.error()而不是console.log()以避免干扰 MCP 协议
3. 环境文件：使用.env文件进行本地开发，以简化设置 API 密钥和其他配置选项

技术实现说明

高级 Mem0 API 参数

使用 Mem0 API 的 Cloud Storage 模式时，您可以利用其他参数进行更复杂的内存管理。虽然工具架构中未明确公开这些参数，但在添加内存时可以将其包含在metadata对象中：

add_memory的高级参数：

要在 MCP 服务器中使用这些参数，请在调用add_memory工具时将它们添加到元数据对象中。例如：

search_memory的高级参数：

Mem0 v2 搜索 API 提供了强大的过滤功能，可以通过filters参数使用：

filters参数支持复杂的逻辑运算（AND、OR）和各种比较运算符：

使用search_memory工具的复杂过滤器的示例：

这将搜索与 Alice 的爱好相关的记忆，其中 user_id 为“alice”并且 agent_id 为“travel-agent”或“sports-agent”，返回最多 5 个结果，相似度得分至少为 0.5。

有关这些参数的更多详细信息，请参阅Mem0 API 文档。

安全记录器

MCP 服务器实现了一个SafeLogger类，该类可以选择性地将 console.log 调用从 mem0ai 库重定向到 stderr，而不会中断 MCP 协议：

• 拦截 console.log 调用并检查堆栈跟踪以确定来源
• 仅重定向来自 mem0ai 库或我们自己的代码的日志调用
• 为 MCP 协议通信保留干净的标准输出
• 进程退出时自动清理资源

这允许 MCP 客户端正常运行，同时保留有用的调试信息。

环境变量

服务器识别几个控制其行为的环境变量：

• MEM0_API_KEY ：云存储模式的 API 密钥
• OPENAI_API_KEY ：本地存储模式（嵌入）的 API 密钥
• DEFAULT_USER_ID ：内存操作的默认用户ID

由 Pink Pixel 用❤️制作