# Mem0.ai记忆管理
## 基本信息
- Slug: `ryaker-mcp-mem0-general`
- Source: modelscope
- Publisher: @ryaker/mcp-mem0-general
- Categories: knowledge-and-memory / rag-systems
- Hosted: No
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@ryaker/mcp-mem0-general
## 简介
一种模型上下文协议服务器，它将AI助手与Mem0.ai的持久记忆系统集成在一起，使模型能够存储、检索、搜索和管理不同类型的记忆。
## MCP Server 详情

# 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](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` 工具。

3.  **查找记忆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](USAGE_GUIDE.md)。

## 文档

- [入门指南](docs/getting-started.md)
- [API 参考](docs/api-reference.md)
- [记忆类型](docs/memory-types.md)
- [高级功能](docs/advanced-features.md)
- [配置](docs/configuration.md)

## 许可证

本项目根据 MIT 许可证发布 - 详情请参阅 [LICENSE](LICENSE) 文件。

## 致谢

- [Mem0.ai](https://mem0.ai) 提供了优秀的记忆 API
- [Model Context Protocol](https://modelcontextprotocol.io/)（及其 Python SDK `mcp`）用于服务器实现
- 所有对此项目做出贡献的人