Mem0 MCP Local Docker

mem0 mcp本地docker

官方服务器通过 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"
      }
    }
  }
}

工具

与官方的主要区别

许可证

Apache许可证2.0