memo-mcp

memo-mcp は、プライベートなセルフホスト型 Mem0 REST API のための、保護された Streamable HTTP MCP ゲートウェイです。Mem0、PostgreSQL、内部 API 認証情報を公開ネットワークに漏らすことなく、小規模で非破壊的なメモリツールのサーフェスを提供します。

これは 1つの信頼されたメモリスコープ のための参照実装です。複数人に使用させる前に、認証済みメンバーシップからメモリスコープを導出するサーバーサイドのポリシーアダプターを統合してください。ブラウザまたは MCP クライアントに MEMORY_SCOPE を選択させてはなりません。

セキュリティモデル

• Mem0 はプライベートに保ち、リバースプロキシ経由でこのゲートウェイのみを公開します。

• ブラウザ以外のクライアントは、専用の取り消し可能なベアラートークンを使用します。

• ブラウザクライアントは、発行者、オーディエンス、不変なサブジェクト、スコープを厳密に検証する OAuth/OIDC トークンイントロスペクションを使用できます。

• memo_remember_fact には、OAuth クライアントで mem0.write が必要です。

• ゲートウェイは意図的にメモリ削除ツールを提供しません。削除は、明示的な承認を伴う別のプライベート管理ワークフローで行ってください。

• ゲートウェイは、一般的な認証情報や秘密鍵の形式を、メモリに書き込まれる前に拒否します。これはセーフティネットであり、運用者のポリシーを置き換えるものではありません。

• 呼び出し元が自分のメモリスコープを選択することは決してできません。マルチユーザー環境では、信頼できるアプリケーションがサーバーサイドのメンバーシップからそのスコープを導出しなければなりません。

Related MCP server: memex

クイックスタート

1. .env.example を .env にコピーし、すべてのプレースホルダーを自分のプライベートな値に置き換えてください。.env をコミットしないでください。

2. プライベートな Docker ネットワークを作成し、docker compose -f compose.example.yml up -d --build でサービスを起動してください。

3. HTTPS で公開するのはこのゲートウェイだけにしてください。Mem0、PostgreSQL、設定済みの環境ファイルは公開しないでください。

4. OAuth が有効な場合、保護リソースのメタデータが 200 を返し、匿名の /mcp リクエストが 401 を返すことを確認してください。

ツール

• memo_search_memory

• memo_remember_fact

設定

.env.example を参照してください。PUBLIC_MCP_URL、MCP_ALLOWED_HOSTS、MCP_ALLOWED_ORIGINS はそれぞれ、あなた自身の HTTPS エンドポイントを表すように設定してください。ゲートウェイは基盤の Mem0 API を X-API-Key で呼び出します。

MCP_ALLOWED_HOSTS は必須です。コンテナのビルドコンテキストでは、.env、Git メタデータ、ローカル Python 成果物が除外されるため、それらがイメージに誤ってコピーされることはありません。

開発

python -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt
python -m unittest discover -s tests -v

このプロジェクトは、ラージな Python MCP SDK を使用しています。