Mem0 General

Mem0 MCP 服务

一个用于将 AI 助手与 Mem0.ai 持久化记忆系统集成的模型上下文协议（MCP）服务。

概述

此服务提供兼容 MCP 的工具，使任何兼容的 AI 助手都能访问和管理存储在 Mem0 中的持久化记忆。它充当 AI 模型与 Mem0 记忆系统之间的桥梁，让助手能够：

• 存储和检索记忆
• 使用语义相似度搜索记忆
• 管理不同类型的记忆（情景记忆、语义记忆、程序记忆）
• 利用短期记忆作为对话上下文
• 应用选择性记忆模式
• 根据记忆创建知识图谱

项目结构

项目代码位于 src/mcp_mem0_general/ 目录中。

安装方式

方式 1：DXT 扩展（推荐）

在 Claude Desktop 中安装此 MCP 服务最简单的方式是使用 DXT 扩展格式。

下载：mem0-mcp-server-0.1.0.dxt

DXT 的详细安装说明请参阅 CLAUDE_DESKTOP_INSTALL.md。

方式 2：直接安装（当前方式）

此服务可以使用 uvx 直接从 GitHub 运行，无需克隆代码仓库或在本地安装。

运行服务

请确保已安装 uv（使用 pipx install uv 或 brew install uv）。

你可以直接在终端中测试此服务：

# Make sure MEM0_API_KEY is set in your environment
export MEM0_API_KEY="your-mem0-api-key-here"

# Run the server using uvx
uvx git+https://github.com/ryaker/mcp-mem0-general.git mcp-mem0-general

服务应会启动并记录其初始化步骤。

方式 3：在 Claude Desktop/Cursor 中手动配置

1. 查找 uvx 路径： Claude Desktop 等 GUI 应用通常不会使用与你的终端相同的 PATH。在终端中运行以下命令，查找 uvx 可执行文件的完整路径：

   which uvx
   

   复制输出的路径（例如 /Users/yourname/.local/bin/uvx 或 /opt/homebrew/bin/uvx）。

2. 配置 MCP： 将以下配置添加到 MCP 配置文件中，并将 /full/path/to/uvx 替换为你在第 1 步中找到的实际路径。

   • Cursor： 在 ~/.cursor/mcp.json 中添加或更新：
   • Claude Desktop： 在设置中添加或更新类似配置。

   "mem0-memory-general": {
     "command": "/full/path/to/uvx", # <-- IMPORTANT: Use the full path from 'which uvx'
     "args": [
       "git+https://github.com/ryaker/mcp-mem0-general.git",
       "mcp-mem0-general"
     ],
     "env": {
       "MEM0_API_KEY": "your-mem0-api-key-here"
     }
   }
   

3. 重启： 重启 Cursor 或 Claude Desktop 以应用更改。此服务现在应能在应用中正常启动。

Claude Desktop 的详细安装说明和故障排除信息请参阅 CLAUDE_DESKTOP_INSTALL.md。

关于 mem0ai[neo4j] 警告的说明

启动时，你可能会看到类似 warning: The package mem0ai==0.1.96 does not have an extra named neo4j 的警告。

• 如果使用托管的 Mem0.ai 平台： 可以放心忽略此警告。必要的图处理由 Mem0 平台在服务端完成。
• 如果使用 Neo4j 自托管 Mem0： 此警告表示特定版本的 mem0ai 未自动安装与 Neo4j 相关的 Python 库（langchain-neo4j、neo4j）。如果要使用图功能，你需要确保在自托管环境中手动安装这些库。

将使用指南加载到记忆中（推荐）

为了让 AI 助手轻松参考服务的功能，你可以将 USAGE_GUIDE.md 的内容加载到 Mem0 中。请按以下步骤操作：

前提条件： 确保 Mem0 MCP 服务正在运行，并已按照上文“入门”部分的说明在 AI 助手（Claude/Cursor）中正确配置。

1. 复制指南内容： 打开 USAGE_GUIDE.md 文件。选中并复制其中的全部文本内容。

2. 请助手添加记忆： 前往 AI 助手（Claude/Cursor），使用类似下面的提示词，并将复制的指南内容粘贴到指定位置。请确保使用一致的 user_id（例如，“default_user”）。

Please remember the following usage guide for the Mem0 MCP server. Use user_id "default_user" and add metadata {"title": "Mem0 MCP Usage Guide", "source": "README Instruction"}:

[--- PASTE THE ENTIRE USAGE_GUIDE.md CONTENT HERE ---]

    The assistant should call the `mem0_add_memory` tool.

3.  **Find the Memory ID:** Once the assistant confirms the memory is added, ask it to find the specific ID for that memory:

    ```
Please search my memories for user_id "default_user" using the query "Mem0 MCP Usage Guide" and tell me the exact memory ID of that guide memory you just added.

助手应使用 `mem0_search_memory` 工具，并向你提供一个 ID 字符串（例如，`76100ac4-896e-488b-90ad-036c0dfaaa80`）。**请记下此 ID！**

4. 稍后检索指南： 现在你已获得 ID，可以随时使用类似下面的提示词，让助手快速调取完整指南：

```
First execute Retrieve memory ID *your-guide-id-here* using mem0_get_memory_by_id. Then return control to me.
```

（将 *`your-guide-id-here`* 替换为你在第 3 步记下的实际 ID）。

记忆类型

服务支持按时长和功能划分的不同记忆类型：

短期记忆

• 对话记忆：回忆近期的消息交流
• 工作记忆：当前正在使用的临时信息
• 注意力记忆：当前关注的信息

长期记忆

• 情景记忆：具体事件和经历
• 语义记忆：事实、概念和知识
• 程序记忆：技能和操作方法

高级功能

• 自定义类别：定义和管理自己的记忆类别
• 记忆指令：设置记忆处理准则
• 图谱关系：访问实体之间的知识图谱关系
• 选择性记忆：存储前使用包含/排除模式筛选文本
• 反馈机制：对记忆质量提供反馈

使用方法

系统中的所有记忆均默认使用“default_user”作为 user_id。

如需查看详细使用示例，请参阅 USAGE_GUIDE.md。

文档

• 入门
• API 参考
• 记忆类型
• 高级功能
• 配置

许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

致谢

• 感谢 Mem0.ai 提供出色的记忆 API
• 感谢 Model Context Protocol（及其 Python SDK mcp）提供服务实现
• 感谢本项目的所有贡献者