M

Mem0.ai记忆管理

@ryaker/mcp-mem0-general
0 Stars 589 次浏览 ryaker 更新于 2026-08-23

一种模型上下文协议服务器,它将AI助手与Mem0.ai的持久记忆系统集成在一起,使模型能够存储、检索、搜索和管理不同类型的记忆。

该服务暂未提供标准配置,请参考 README 手动接入

服务介绍

Mem0 MCP 服务器

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

概述

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

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

项目结构

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

开始使用(无需安装!)

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

运行服务器

确保已安装 uv (pipx install uvbrew 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!**
  1. 稍后检索指南: 现在你有了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)用于服务器实现
  • 所有对此项目做出贡献的人

相关 MCP 服务