Mem0.ai记忆管理
一种模型上下文协议服务器,它将AI助手与Mem0.ai的持久记忆系统集成在一起,使模型能够存储、检索、搜索和管理不同类型的记忆。
服务介绍
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 中设置
-
查找
uvx路径: 像 Claude Desktop 这样的 GUI 应用程序通常不使用与您的终端相同的PATH。通过在终端中运行以下命令找到uvx可执行文件的完整路径:
bash
which uvx复制输出路径(例如
/Users/yourname/.local/bin/uvx或/opt/homebrew/bin/uvx)。 -
配置 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"
}
} - Cursor: 在
-
重启: 重启 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)中正确配置,如上文“开始使用”部分所述。
-
复制指南内容: 打开 USAGE_GUIDE.md 文件。选择并复制其全部文本内容。
-
要求助手添加记忆: 转到您的 AI 助手(Claude/Cursor),使用类似于以下的提示,将您复制的指南内容粘贴到指定位置。确保使用一致的
user_id(例如 "default_user")。
请记住以下关于 Mem0 MCP 服务器的使用指南。使用 user_id "default_user" 并添加元数据 {"title": "Mem0 MCP 使用指南", "source": "README 说明"}:
[--- 在此处粘贴整个 USAGE_GUIDE.md 内容 ---]助手应调用 mem0_add_memory 工具。
- 查找记忆ID: 一旦助手确认已添加记忆,请要求它找到该记忆的具体ID:
请使用查询 "Mem0 MCP 使用指南" 搜索 user_id 为 "default_user" 的记忆,并告诉我刚才添加的指南记忆的确切记忆ID。
助手应使用 `mem0_search_memory` 工具并提供一个ID字符串(例如,`76100ac4-896e-488b-90ad-036c0dfaaa80`)。**记下这个ID!**
- 稍后检索指南: 现在你有了ID,可以随时快速要求助手通过如下提示来回忆完整的指南:
首先执行使用 mem0_get_memory_by_id 检索记忆ID your-guide-id-here。然后将控制权返回给我。
(将 *`your-guide-id-here`* 替换为你在步骤3中记下的实际ID)。
记忆类型
服务器支持按持续时间和功能组织的不同记忆类型:
短期记忆
- 对话记忆:最近消息交换的回忆
- 工作记忆:正在积极使用的临时信息
- 注意记忆:当前关注的信息
长期记忆
- 情景记忆:特定事件和经历
- 语义记忆:事实、概念和知识
- 程序记忆:技能和操作信息
高级功能
- 自定义类别:定义和管理自己的记忆类别
- 记忆指令:设置记忆处理的指导方针
- 图关系:访问实体之间的知识图谱关系
- 选择性记忆:在存储前使用包含/排除模式过滤文本
- 反馈机制:对记忆质量提供反馈
使用方法
系统中的所有记忆默认使用 "default_user" 作为 user_id。
有关详细的使用示例,请参阅 USAGE_GUIDE.md。
文档
许可证
本项目根据 MIT 许可证发布 - 详情请参阅 LICENSE 文件。
致谢
- Mem0.ai 提供了优秀的记忆 API
- Model Context Protocol(及其 Python SDK
mcp)用于服务器实现 - 所有对此项目做出贡献的人