Mem0.ai Memory Manager

🚀 Mem0 MCP 服務器

這是一個為集成 AI 助手與 Mem0.ai 持久記憶系統提供 Model Context Protocol (MCP) 的服務，能讓 AI 助手更好地訪問和管理記憶，提升交互體驗。

🚀 快速開始

此服務器可直接使用 uvx 從 GitHub 運行，無需克隆倉庫或在本地安裝。下面為你詳細介紹啟動和配置步驟。

運行服務器

確保你已經安裝了 uv（可通過 pipx install uv 或 brew install uv 進行安裝），然後在終端執行以下命令來啟動服務器：

# 確保 MEM0_API_KEY 設置在你的環境中
export MEM0_API_KEY="your-mem0-api-key-here"

# 使用 uvx 運行服務器
uvx git+https://github.com/ryaker/mcp-mem0-general.git mcp-mem0-general

服務器啟動後會記錄其初始化步驟。

在 Cursor 或 Claude Desktop 中配置

找到 uvx 路徑

GUI 應用程序（如 Claude Desktop）通常不使用與終端相同的 PATH。通過以下命令在終端中找到 uvx 的完整路徑：

which uvx

複製輸出的路徑（例如 /Users/yourname/.local/bin/uvx 或 /opt/homebrew/bin/uvx）。

配置 MCP

在你的 MCP 配置文件中添加以下配置，用實際找到的路徑替換 /full/path/to/uvx。

• Cursor：

mcp.server.url=http://localhost:7860
mcp.server.plugin=mem0
mem0.apiUrl=https://api.mem0.ai
mem0.apiKey=$MEM0_API_KEY

• Claude Desktop：在 config.json 文件中添加以下內容：

"mcp": {
  "servers": [
    {
      "url": "http://localhost:7860",
      "plugins": ["mem0"]
    }
  ]
},
"env": {
  "MEM0_API_KEY": "your-mem0-api-key-here"
}

重啟應用程序

保存配置文件後，重啟 Cursor 或 Claude Desktop。

✨ 主要特性

此服務器提供了與 Mem0 兼容的工具，作為 AI 模型與 Mem0 記憶系統之間的橋樑，使兼容的 AI 助手能夠：

• 存儲和檢索記憶
• 通過語義相似性搜索記憶
• 管理不同類型的記憶（episodic、semantic、procedural）
• 利用短期記憶管理對話上下文
• 應用選擇性記憶模式
• 從記憶中創建知識圖譜

📦 安裝指南

安裝依賴項

pip install mcp mem0 python-dotenv

複製配置文件

cp src/mcp_mem0_general/config-template.json src/mcp_mem0_general/config.json
nano src/mcp_mem0_general/config.json  # 更新 API_KEY 字段

運行服務器

python -m mcp.server

💻 使用示例

所有記憶系統中都使用 "default_user" 作為默認的 user_id。有關詳細用法示例，請參見 USAGE_GUIDE.md。

📚 詳細文檔

• 快速入門
• API 參考
• 記憶類型
• 高級功能
• 配置

📄 許可證

此項目遵循 MIT 許可證，有關詳細信息，請參閱 LICENSE 文件。

致謝

• Mem0.ai 提供了出色的記憶 API
• Model Context Protocol（及其 Python SDK mcp）用於服務器實現
• 此項目的所有貢獻者

項目結構

項目的代碼位於 src/mcp_mem0_general/ 目錄內。