Mem0 MCP

🚀 Mem0 MCP 服務器配置指南

本指南將指導你完成 Mem0 MCP 服務器的配置和使用，幫助你快速搭建記憶存儲與檢索服務。

🚀 快速開始

要運行 Mem0 MCP 服務器，請執行以下步驟：

# 安裝依賴項
npm install mem0ai safeLogger

# 啟動服務器
node src/index.js --mode [cloud/local] [--userId <默認用戶ID>]

✨ 主要特性

• 支持雲存儲和本地存儲兩種模式，滿足不同場景需求。
• 提供 add_memory 和 search_memory 核心工具，方便記憶的添加和檢索。
• 支持高級參數配置，可靈活定製記憶處理規則。

📦 安裝指南

依賴安裝

運行以下命令安裝必要的依賴：

npm install mem0ai safeLogger

啟動服務器

使用以下命令啟動服務器：

node src/index.js --mode [cloud/local] [--userId <默認用戶ID>]

其中，--mode 參數可選值為 cloud 或 local，分別代表雲存儲模式和本地存儲模式。

💻 使用示例

基礎用法

添加記憶

{
  "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
}

📚 詳細文檔

配置選項

MCP 服務器支持兩種運行模式：

• 雲存儲模式：使用 Mem0 的雲服務來存儲和檢索記憶。需要設置 MEM0_API_KEY 環境變量。
• 本地存儲模式：在本地使用 OpenAI embeddings 來處理記憶。需要設置 OPENAI_API_KEY 環境變量。

核心工具

add_memory

• 說明：添加新的記憶內容到存儲。
• 輸入格式：

{
  "content": string,
  "userId": string,
  "sessionId": string (可選),
  "metadata": object (可選)
}

• 輸出：返回成功狀態或錯誤信息。

search_memory

• 說明：根據查詢從存儲中檢索相關記憶。
• 輸入格式：

{
  "query": string,
  "userId": string,
  "filters": object (可選),
  "top_k": number (可選, 默認10),
  "threshold": number (可選, 默認0.3)
}

• 輸出：返回匹配記憶列表及相似度評分。

高級參數

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, // 是否重新排序，默認否
  "keyword_search": boolean, // 是否關鍵詞搜索，默認否
  "filter_memories": boolean, // 是否過濾記憶，默認否
  "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 官方文檔獲取最新信息。