Mem0 MCP

🚀 Mem0 MCP サーバー構成ガイド

Mem0 MCP サーバーは、記憶の管理と検索を効率的に行うためのサーバーです。このガイドでは、サーバーの構成方法、使用方法、およびその他の重要な情報について説明します。

🚀 クイックスタート

Mem0 MCP サーバーを実行するには、以下の手順を実行してください。

# 依存関係のインストール
npm install mem0ai safeLogger

# サーバーの起動
node src/index.js --mode [cloud/local] [--userId <デフォルトユーザーID>]

✨ 主な機能

MCP サーバーは、2 つの実行モードをサポートしています。

• クラウドストレージモード：Mem0 のクラウドサービスを使用して、記憶を保存および検索します。MEM0_API_KEY 環境変数を設定する必要があります。
• ローカルストレージモード：ローカルで OpenAI embeddings を使用して、記憶を処理します。OPENAI_API_KEY 環境変数を設定する必要があります。

📦 インストール

依存関係のインストール

npm install mem0ai safeLogger

サーバーの起動

node src/index.js --mode [cloud/local] [--userId <デフォルトユーザーID>]

💻 使用例

基本的な使用法

メモリの追加

{
  "content": "重要情報を覚えておく必要があります",
  "userId": "user123",
  "sessionId": "project-abc",
  "metadata": {
    "custom_instructions": "このメモリを優先的に処理してください"
  }
}

メモリの検索

{
  "query": "最近のプロジェクトの更新",
  "userId": "user123",
  "filters": {
    "AND": [
      { "field": "project_id", "value": "abc123" },
      { "field": "timestamp", "operator": ">", "value": "2023-01-01" }
    ]
  },
  "top_k": 5
}

高度な使用法

add_memory の高度なオプション

{
  "content": "string",
  "userId": "string",
  "sessionId": "string (オプション)",
  "metadata": {
    "includes": "string", // 特定の包含の好み
    "excludes": "string", // 特定の除外の好み
    "immutable": "boolean", // 不変かどうか
    "expiration_date": "string", // 有効期限、形式: YYYY-MM-DD
    "custom_instructions": "string", // プロジェクト固有の指示
    "version": "string" // メモリのバージョン、デフォルトは v2
  }
}

search_memory の高度なオプション

{
  "query": "string",
  "userId": "string",
  "filters": {
    "OR": [ 条件配列 ] | 
    "AND": [ 条件配列 ]
  },
  "top_k": "number", // 最大返却結果数
  "threshold": "number", // 類似度の閾値
  "fields": "string[]", // 返却する具体的なフィールド
  "rerank": "boolean", // 再ランク付けするかどうか、デフォルトは false
  "keyword_search": "boolean", // キーワード検索を行うかどうか、デフォルトは false
  "filter_memories": "boolean", // メモリをフィルタリングするかどうか、デフォルトは false
  "org_id": "string", // 組織 ID のフィルタリング
  "project_id": "string" // プロジェクト ID のフィルタリング
}

📚 ドキュメント

環境変数

# 必須設定
MEM0_API_KEY=your_api_key # クラウドモードの場合に必要

OR
OPENAI_API_KEY=your_api_key # ローカルモードの場合に必要

# オプション設定
DEFAULT_USER_ID=user123 # デフォルトユーザー ID
PORT=3000 # カスタムサービスポート
LOG_LEVEL=info # ログレベル

セキュリティに関する注意事項

• API キーを安全に保管し、漏洩を防いでください。
• 機密データを扱う場合は、暗号化技術を使用してください。
• 重要なメモリデータを定期的にバックアップしてください。

エラー処理

パフォーマンス最適化

• 期限切れのメモリを定期的に削除してください。
• 適切なキャッシュポリシーを設定してください。
• 高い同時アクセス要求を処理するために、ロードバランシングを使用してください。

モニタリングとログ

• アプリケーションパフォーマンスモニタリングツールを統合してください。
• ログファイルを分析して、問題を特定してください。
• 異常な状況に対応するために、アラートメカニズムを設定してください。

トラブルシューティング

問題が発生した場合は、以下の手順を参照してください。

1. サービスが正常に動作していることを確認してください。
2. 最新のログを確認して、エラーメッセージを取得してください。
3. API キーと設定が正しいことを確認してください。
4. Mem0 サポートチームに連絡して、支援を求めてください。

付録

• サポートされているフィルタ演算子：=, >, <, >=, <=, !=
• ログ形式：[timestamp] [level] [message]
• デフォルトポート：3000

⚠️ 重要提示

このドキュメントの内容は更新される場合があります。最新情報を取得するために、定期的に Mem0 の公式ドキュメントを参照することをお勧めします。