mcp-mem0

mem0（セルフホスト / オープンソース）向けの MCPサーバーで、Qdrant をバックエンドに使用します。各リクエストは HTTPヘッダーで指定された名前の Qdrant コレクション を対象とするため、同じ名前を送信するクライアントはメモリを共有し、異なる名前は分離されたままになります。

ツール

Related MCP server: mem0-open-mcp

コレクションルーティングの仕組み

• コレクション名 は HTTPヘッダー（デフォルトでは X-Collection）から読み取られ、Qdrant コレクション mem0_<name> にマッピングされます（プレフィックスは設定可能。空に設定すると値をそのまま使用します）。ヘッダー値は ^[A-Za-z0-9_-]{1,64}$ に対して検証されます。

• 共有: 同じコレクション名を送信するクライアントは同じメモリを共有します。異なる名前は分離されます。

• コレクションごとに1つの AsyncMemory インスタンスが構築され、キャッシュされます。

• コレクションはヘッダーのみで選択されます。user_id / agent_id / run_id は使用するコレクションに一切影響せず、コレクション内の絞り込みにのみ使用され、省略可能です。これらを指定せずに検索・一覧表示すると、コレクション全体が対象になります。

• add_memory は保存時に1つのIDを必要とします（mem0の要件）。書き込み時に呼び出し側が3つすべてを省略した場合は、デフォルトの user_id（MEM0_DEFAULT_USER_ID）が適用されます。

クイックスタート

# 1. Start Qdrant
docker compose up -d qdrant

# 2. Configure
cp .env.example .env
# edit .env: set OPENAI_API_KEY (or switch to the Ollama block for a key-free setup)

# 3. Run the server (streamable-HTTP on :8080/mcp)
uv run -m mcp_mem0

ヘルスチェック: curl localhost:8080/health

Docker

Dockerfile はマルチステージ構成で、runtime（サーバー）と test（テストスイート）の2つのターゲットがあります。

docker compose を使用する場合（推奨）

cp .env.example .env          # set OPENAI_API_KEY (or the Ollama block)

# Qdrant + server together
docker compose up -d --build qdrant server
curl localhost:8080/health

# Run unit tests (no Qdrant / keys needed)
docker compose run --rm tests

# End-to-end smoke against the running server (needs an embedder key)
docker compose run --rm tests python tests/smoke.py

compose ネットワーク内では、サーバーは QDRANT_HOST=qdrant で Qdrant に到達します（自動設定）。テストは MCP_URL=http://server:8080/mcp でサーバーに到達します。

通常の docker を使用する場合

# Service image
docker build --target runtime -t mcp-mem0 .
docker run --rm -p 8080:8080 --env-file .env -e QDRANT_HOST=host.docker.internal mcp-mem0

# Test image
docker build --target test -t mcp-mem0-test .
docker run --rm mcp-mem0-test            # pytest -q

検証

# Unit tests (no Qdrant needed)
uv run pytest -q

# End-to-end smoke test (server + Qdrant + embedder must be running)
uv run python tests/smoke.py

# Confirm per-client collections were created
curl localhost:6333/collections

設定

すべての設定は環境変数 / .env から取得されます — .env.example を参照してください。主なもの: MEM0_COLLECTION_HEADER、MEM0_COLLECTION_PREFIX、QDRANT_HOST/QDRANT_PORT（または QDRANT_URL+QDRANT_API_KEY）、MEM0_EMBEDDING_DIMS（エンベッダーと一致させる必要があります）、および MEM0_LLM_* / MEM0_EMBEDDER_* プロバイダーブロック（openai / ollama / …）。