MCP Memory

---

MCP Memory

MCP Memory は、ユーザーの情報（好み、行動）を会話をまたいで記憶する機能を **MCP クライアント（Cursor、Claude、Windsurf など）**に提供する MCP サーバーです。キーワードだけでなく意味に基づいて関連する記憶を見つけるため、ベクトル検索技術を使用しています。Cloudflare Workers、D1、Vectorize（RAG）、Durable Objects、Workers AI、Agents を使用して構築されています。

📺 動画

🚀 試してみる

https://memory.mcpgenerator.com/

🛠️ 独自の MCP Memory をデプロイする方法

オプション 1：Cloudflare に独自の MCP Memory をワンクリックでデプロイする

Create Vectorize セクションで次を選択します：

• Dimensions： 1024
• Metric： cosine

"Create and Deploy" ボタンをクリックします。

Cloudflare ダッシュボードで「Workers & Pages」に移動し、「Visit」をクリックします。

オプション 2：このテンプレートを使用する

1. このリポジトリの上部にある「Use this template」ボタンをクリックします
2. 新しいリポジトリをクローンします
3. 以下のセットアップ手順に従います

オプション 3：CloudFlare CLI で作成する

npm create cloudflare@latest --git https://github.com/puliczek/mcp-memory

🔧 セットアップ（オプション 2 と 3 のみ）

1. 依存関係をインストールします：

npm install

2. Vectorize インデックスを作成します：

npx wrangler vectorize create mcp-memory-vectorize --dimensions 1024 --metric cosine

3. Wrangler をインストールします：

npm run dev

4. Worker をデプロイします：

npm run deploy

🧠 仕組み

1. 記憶の保存：

   • テキストは、オープンソースの @cf/baai/bge-m3 モデルを使用して Cloudflare Workers AI で処理され、埋め込みが生成されます
   • テキストとそのベクトル埋め込みは、次の 2 か所に保存されます：
     • Cloudflare Vectorize：類似検索用のベクトル埋め込みを保存します
     • Cloudflare D1：永続化のために元のテキストとメタデータを保存します
   • Durable Object（MyMCP）が状態を管理し、一貫性を確保します
   • Agents フレームワークが MCP プロトコルの通信を処理します

2. 記憶の取得：

   • クエリは、同じ @cf/baai/bge-m3 モデルを使用して Workers AI でベクトルに変換されます
   • Vectorize が類似検索を実行し、関連する記憶を見つけます
   • 結果は類似度スコアで順位付けされます
   • D1 データベースが、一致したベクトルに対応する元のテキストを提供します
   • Durable Object が取得プロセスを調整します

このアーキテクチャにより、次のことが可能になります：

• Vectorize による高速なベクトル類似検索
• D1 による永続的なストレージ
• Durable Objects によるステートフルな操作
• Workers AI による標準化された AI インタラクション
• Agents フレームワークによるプロトコル準拠

このシステムは、完全に同じ単語が使われていない場合でも、概念的に関連する情報を見つけます。

🔒 セキュリティ

MCP Memory は、ユーザーデータを保護するために複数のセキュリティ対策を実装しています：

• データを分離するため、各ユーザーの記憶は Vectorize 内の分離された名前空間に保存されます
• 組み込みのレート制限により、不正利用を防ぎます（100 req/min。wrangler.jsonc で変更できます）
• 認証は userId のみを基準としています
  • レート制限により、基本的な保護としては十分です
  • 必要に応じて、追加の認証レイヤー（API キーや OAuth など）を簡単に追加できます
• すべてのデータは Cloudflare の安全なインフラストラクチャに保存されます
• すべての通信は業界標準の TLS 暗号化によって保護されます（Cloudflare の SSL/TLS 証明書により自動的に提供されます）

💰 費用について - ほとんどのユーザーは無料です

MCP Memory は、通常の使用量であれば無料で利用できます。

• 無料枠では、1,000 件のメモリを保存でき、月に約 28,000 回クエリできます
• Workers、Vectorize、Worker AI、D1 データベースの Cloudflare 無料枠を使用します

Cloudflare の料金について詳しくは、以下をご覧ください。

• Vectorize の料金
• Workers AI の料金
• Workers の料金
• Durable Objects の料金
• Database D1 の料金

❓ よくある質問

1. memory.mcpgenerator.com を使ってメモリを保存できますか？

   • はい、memory.mcpgenerator.com を使ってメモリを保存、取得できます
   • サービスは無料です
   • メモリは安全に保存され、自分だけがアクセスできます
   • サービスが常に利用可能であることは保証できません

2. 自分でホストできますか？

   • はい、Cloudflare 上で MCP Memory の独自インスタンスを無料でホストできます
   • Cloudflare アカウントと、以下のサービスが必要です。
     • Workers
     • Vectorize
     • D1 Database
     • Workers AI

3. ローカルで実行できますか？

   • はい、開発用に MCP Memory をローカルで実行できます
   • wrangler dev を使ってワーカーをローカルで実行してください
   • Cloudflare サービス用のローカル開発認証情報を設定する必要があります
   • ベクトル検索や workers AI などの一部機能には、Cloudflare サービスへの接続が必要です

4. 別のホスティングを利用できますか？

   • いいえ、MCP Memory は Cloudflare のインフラストラクチャ向けに特化して設計されています

5. なぜこれを作ったのですか？

   • オープンソースのソリューションが欲しかったためです
   • 自分のデータを管理できることが重要だったためです

6. 複数人で利用できますか？

   • はい、MCP Memory をアプリに統合して、すべてのユーザーに提供できます
   • ユーザーごとに独立したメモリ空間が用意されます

7. メモリ以外の情報も保存できますか？

   • はい、MCP Memory にはあらゆる種類のテキストベースの情報を保存できます
   • 実用例：
     • ナレッジベース：技術文書、手順、トラブルシューティングガイドを保存
     • ユーザーの行動：ユーザーの機能利用状況や一般的な利用パターンを追跡
     • プロジェクトノート：決定事項やプロジェクトの進捗を記録
   • ベクトル検索により、コンテンツの種類を問わず関連項目を見つけられます

🤝 応援する