Mem0 MCP 服务器

一个用于将 AI 助手与 Mem0.ai 的持久内存系统集成的模型上下文协议 (MCP) 服务器。

概述

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

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

项目结构

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

开始使用（无需安装！）

此服务器可以直接通过 GitHub 使用 uvx 运行，而无需克隆仓库或本地安装。

运行服务器

确保已安装 uv (pipx install uv 或 brew install uv)。

您可以在终端中直接测试服务器：

bash

确保 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 中设置

1. 查找 uvx 路径： 像 Claude Desktop 这样的 GUI 应用程序通常不使用与您的终端相同的 PATH。通过在终端中运行以下命令找到 uvx 可执行文件的完整路径： bash 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: 在您的设置中添加/更新类似的配置。

   json "mem0-memory-general": { "command": "/full/path/to/uvx", # <-- 重要：使用 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 以应用更改。现在服务器应在应用程序中正确启动。

关于 mem0ai[neo4j] 警告的说明

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

• 如果使用托管的 Mem0.ai 平台： 此警告可以安全忽略。必要的图形处理发生在 Mem0 平台的服务器端。
• 如果自托管 Mem0 并使用 Neo4j： 此警告表明特定版本的 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"）。

请记住以下关于 Mem0 MCP 服务器的使用指南。使用 user_id "default_user" 并添加元数据 {"title": "Mem0 MCP 使用指南", "source": "README 说明"}：

[--- 在此处粘贴整个 USAGE_GUIDE.md 内容 ---]助手应调用 mem0_add_memory 工具。

1. 查找记忆ID： 一旦助手确认已添加记忆，请要求它找到该记忆的具体ID：

请使用查询 "Mem0 MCP 使用指南" 搜索 user_id 为 "default_user" 的记忆，并告诉我刚才添加的指南记忆的确切记忆ID。

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

4. 稍后检索指南： 现在你有了ID，可以随时快速要求助手通过如下提示来回忆完整的指南：

首先执行使用 mem0_get_memory_by_id 检索记忆ID your-guide-id-here。然后将控制权返回给我。

（将 *`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）用于服务器实现
• 所有对此项目做出贡献的人