OpenMemory MCP

OpenMemory MCP 的安装与使用主要依赖于 Docker 环境，整体流程分为环境准备、安装配置、启动服务以及客户端接入四个步骤。以下是详细的操作指南：

一、 前提条件

在开始安装之前，请确保您的电脑上已安装以下软件环境：

• Docker 和 Docker Compose（用于一键部署服务）
• Python 3.9+
• Node.js
• GNU Make
• OpenAI API 密钥（或者兼容 OpenAI 格式的第三方大模型 API）

---

二、 安装与配置步骤

1. 克隆代码仓库 首先，将 mem0 的代码库克隆到本地，并进入 openmemory 目录：

git clone https://github.com/mem0ai/mem0.git
cd mem0/openmemory

2. 生成并配置环境变量 执行以下命令生成环境配置文件：

make env

该命令会在 api 目录和 ui 目录下分别创建 .env 文件。打开 api/.env 文件，填入你的大模型 API 密钥：

OPENAI_API_KEY=sk-xxxxxx
# 如果使用的是第三方兼容接口，还需要添加 BASE_URL：
OPENAI_BASE_URL=https://api.your-provider.com/v1

3. 构建 Docker 镜像 执行以下命令，系统会基于 docker-compose.yml 自动构建后端 API（包含 MCP 服务器）和前端 UI 的镜像：

make build

---

三、 启动服务

1. 启动后端数据库与 API 服务 执行以下命令，启动 Postgres 数据库、Qdrant 向量数据库以及 FastAPI/MCP 服务器：

make up

2. 启动前端仪表板（UI） （如果在 make up 中前端没有自动暴露，可以通过以下命令单独启动前端：）

make ui

启动完成后，您可以在浏览器中访问 http://localhost:3000。这是 OpenMemory 的可视化控制台（Dashboard），您可以在这里查看、添加、修改、删除所有 AI 产生的记忆，并管理各个客户端的访问权限。

---

四、 客户端连接与使用

服务启动后，您就可以让支持 MCP 协议的 AI 工具（如 Cursor、Claude Desktop、Windsurf、Cline 等）接入这个本地记忆库了。

1. 获取接入链接 在浏览器打开的 Dashboard (http://localhost:3000) 中，系统会提供接入客户端的具体配置参数或链接。 通常，OpenMemory 是通过 SSE (Server-Sent Events) 协议与客户端通信的。其连接 URL 格式通常类似于： http://localhost:8765/mcp/openmemory/sse/your_user_id （端口和具体路径请以仪表板显示为准）。

2. 在 AI 工具中配置 以 Claude Desktop 或 LangGraph 为例，你只需在它们的 MCP 配置文件中添加上述 URL 链接，传输方式（transport）选择 sse 即可。

3. 跨工具使用 配置完成后，AI 工具将自动获得以下核心能力，您无需手动干预：

• 自动存储 (add_memories)：当你在 Cursor 里告诉 AI "我习惯使用 TypeScript"，AI 会自动将这条偏好存入 OpenMemory。
• 自动检索 (search_memory)：当你切换到 Windsurf 或 Claude 时，AI 在回答前会去本地搜索相关记忆，从而直接知道你的编程习惯，实现"一处设置，到处可用"的跨工具记忆共享体验。