星战科技xingzhan.cloud
返回市场
MCP-内存0-通用

MCP-内存0-通用

作者：ryaker15 星标更新：2025-08-12
安装使用来源：spider==github.com

项目介绍

Mem0 MCP Server

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

概述

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

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

项目结构

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

安装方法

方法1：DXT扩展（推荐）

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

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

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

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

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

运行服务器

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

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

# 确保环境变量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

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

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

  1. 找到uvx路径：GUI应用程序如Claude Desktop通常不使用与您的终端相同的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", # <-- 重要：使用`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]警告的注意事项

在启动时，您可能会看到类似警告：包mem0ai==0.1.96没有名为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`工具。

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

    ```
请在我的记忆中搜索user_id "default_user"，使用查询“Mem0 MCP 使用指南”，告诉我刚刚添加的指南记忆的确切记忆ID。

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

4. 稍后检索指南：现在您有了ID，可以随时要求助手召回完整的指南，使用类似于以下提示：

```

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


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

## 记忆类型

服务器支持按持续时间和功能组织的不同类型的记忆：

### 短期记忆
- **对话记忆**：最近消息交换的回忆
- **工作记忆**：正在积极使用的临时信息
- **注意力记忆**：当前关注的信息

### 长期记忆
- **情节记忆**：特定事件和经历
- **语义记忆**：事实、概念和知识
- **程序记忆**：技能和如何信息

## 高级功能
- **自定义类别**：定义和管理自己的记忆类别
- **记忆指令**：设定记忆应如何处理的指导方针
- **图关系**：访问实体之间的知识图关系
- **选择性记忆**：在存储之前使用包含/排除模式过滤文本
- **反馈机制**：提供关于记忆质量的反馈

## 使用
系统中的所有记忆默认使用"user_id"为"default_user"。

有关详细的使用示例，请参阅[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
- [模型上下文协议](https://modelcontextprotocol.io/)（及其Python SDK `mcp`）用于服务器实现
- 所有对此项目的贡献者