磨刀的学习笔记
技术记录 · 学习心得
📝 学习笔记
Mem0 自托管记忆服务部署实践

Mem0 是一个为 AI 应用提供长期记忆能力的开源项目。它可以让 AI 助手「记住」用户的偏好、历史对话和重要信息,从而提供更个性化的服务。

为什么选择自托管?

官方提供的 Mem0 Cloud 虽然方便,但对于个人项目和学习来说,自托管有以下优势:

  • 完全控制数据,隐私更安全
  • 可以自定义配置 LLM 和 Embedder
  • 学习技术架构的最佳实践

核心组件

Mem0 自托管包含三个主要部分:

  • Mem0 Server - REST API 服务,提供记忆的增删改查
  • Mem0 Dashboard - Web 界面,可视化管理记忆数据
  • Qdrant - 向量数据库,存储 Embedding 后的记忆
💡
关键配置:使用阿里云 DashScope 的 DeepSeek 模型作为 LLM,text-embedding-v3 作为 Embedder。这样既保证了性能,又控制了成本。

HTTPS 配置要点

部署过程中遇到 HTTP 下 Cookie Secure 属性导致无法登录的问题。解决方案:

  • 使用域名 + HTTPS,而不是裸 IP
  • 通过 acme.sh 申请 Let's Encrypt 证书
  • Nginx 反向代理统一入口
OpenMemory MCP 服务集成指南

OpenMemory 是 Mem0 团队开发的 MCP (Model Context Protocol) 服务,让 Claude Code 等 AI 工具能够持久化记忆。

MCP 是什么?

MCP 是 Anthropic 提出的标准化协议,用于连接 AI 模型与外部工具和数据源。简单来说,它让 AI 能够:

  • 访问本地文件、数据库
  • 调用外部 API
  • 持久化存储信息(这正是 OpenMemory 的用途)

部署架构

┌─────────────────┐     ┌──────────────────┐
│   Claude Code   │────▶│   OpenMemory MCP │
│   (客户端)       │     │   (MCP 服务)      │
└─────────────────┘     └──────────────────┘
                              │
                              ▼
                        ┌──────────────┐
                        │   Qdrant     │
                        │   (向量存储)  │
                        └──────────────┘

配置要点

在 Claude Code 的 MCP 配置文件中添加:

{
  "mcpServers": {
    "mem0": {
      "type": "http",
      "url": "http://your-server:8765/mcp/claude-code/http/default-user"
    }
  }
}
⚠️
注意:由于国内 ICP 限制,HTTPS 域名访问可能被拦截。当前使用 HTTP 端口转发作为临时方案,待备案后可切换到域名访问。

实际效果

配置完成后,Claude Code 会自动将重要信息存储到 OpenMemory。例如用户偏好、项目上下文等,在后续对话中可以被召回使用,实现「跨会话记忆」。