使用说明
mem0 mcp本地docker
自托管 Mem0 MCP服务器改编自 官方成员0 mcp 使用Docker容器（PostgreSQL与pgvector+Neo4j）完全在自己的基础设施上运行。
官方服务器通过 MemoryClient。这个叉子用本地叉子代替了它 Memory 类，指向您自己的Postgres和Neo4j实例。
先决条件
- Docker&Docker编写
- Python>=3.10
- OpenAI API密钥（由Mem0内部用于嵌入和LLM）
建筑
┌─────────────────────────────────┐
│ MCP Client (OpenCode, Claude) │
└──────────────┬──────────────────┘
│ stdio
┌──────────────▼──────────────────┐
│ mem0-mcp-server (Python) │
│ src/mem0_mcp_server/server.py │
└──┬───────────────────────────┬──┘
│ │
┌──▼─────────────┐ ┌─────────▼──────────┐
│ PostgreSQL │ │ Neo4j │
│ (pgvector) │ │ (graph store) │
│ port: 8432 │ │ port: 8687 │
└────────────────┘ └────────────────────┘
设置
1.克隆和配置
git clone https://github.com/materializerx/mem0-mcp-local-docker.git
cd mem0-mcp-local-docker
cp .env.example .env
编辑 .env 并设置您的 OPENAI_API_KEY。其他默认值与包含的匹配 docker-compose.yml.
2.开始支持服务
docker compose up -d
这将在端口上启动PostgreSQL（pgvector） 8432 端口上的Neo4j 8687。两者都配置了 restart: unless-stopped 所以它们能在重启后存活下来。
等待健康状态：
docker compose ps
3.安装依赖项
uv sync
# or
pip install -e .
4.运行服务器
uv run mem0-mcp-server
# or
python -m mem0_mcp_server.server
服务器运行超时 标准 默认情况下（用于MCP客户端集成）。
MCP客户端配置
OpenCode(oh-my-opencode.json)
{
"mcp": {
"mem0": {
"type": "stdio",
"command": "/path/to/mem0-mcp/.venv/bin/python",
"args": ["-m", "mem0_mcp_server.server"],
"env": {
"OPENAI_API_KEY": "sk-...",
"MEM0_DEFAULT_USER_ID": "sisyphus",
"MEM0_ENABLE_GRAPH_DEFAULT": "true"
}
}
}
}
克劳德桌面
{
"mcpServers": {
"mem0": {
"command": "uvx",
"args": ["mem0-mcp-server"],
"env": {
"OPENAI_API_KEY": "sk-...",
"MEM0_DEFAULT_USER_ID": "your-handle",
"MEM0_ENABLE_GRAPH_DEFAULT": "true"
}
}
}
}
工具
| 工具 | 说明 |
|---|---|
add_memory |
存储偏好、事实或对话片段 |
search_memories |
对现有记忆的语义搜索 |
get_memories |
列出带有过滤器和分页的内存 |
get_memory |
按ID获取单个内存 |
update_memory |
覆盖内存的文本 |
delete_memory |
删除单个内存 |
delete_all_memories |
批量删除作用域中的所有内存 |
delete_entities |
删除用户/代理/运行并级联删除其内存 |
与官方的主要区别
| 方面 | 官方(mem0ai/mem0-mcp) |
这个叉子 |
|---|---|---|
| 后端 | Mem0云API(MemoryClient) |
本地 Memory 班级 |
| Vector Store | Mem0 Cloud | 自托管PostgreSQL+pgvector |
| Graph Store | Mem0 Cloud | 自托管Neo4j |
| LLM | Mem0云 | OpenAI API（可配置模型） |
| 嵌入器 | Mem0云 | OpenAI text-embedding-3-small |
| 认证 | MEM0_API_KEY |
OPENAI_API_KEY +DB凭据 |
list_entities |
支持 | 不可用（返回错误） |
