Mem0 Memory MCP Server

一个使用Mem0提供内存存储和检索能力的模型上下文协议(MCP)服务器。此工具允许您存储和搜索记忆，使其在维护上下文和基于过去交互做出明智决策方面非常有用。

特性

• 使用用户特定的上下文存储记忆
• 按相关性评分搜索存储的记忆
• 简单直观的API
• 基于模型上下文协议构建
• 自动错误处理
• 支持多个用户上下文

使用方法

此服务器现在支持通过Smithery CLI的StreamableHTTP，同时保留可选的STDIO兼容性。

StreamableHTTP（推荐）

• 开发（打开Smithery Playground并暴露HTTP传输）：

npm run dev

• 构建用于HTTP/StreamableHTTP（Smithery）：

npm run build

• 在本地启动HTTP服务器（Smithery构建的入口点）：

npm run start:http

您可以使用Smithery生成的表单在playground中配置服务器，或通过设置环境变量（例如MEM0_API_KEY）进行配置。

STDIO（向后兼容）

通过STDIO运行服务器（适用于仅支持STDIO的本地客户端）：

env MEM0_API_KEY=your-api-key-here npm run build:stdio && npm run start:stdio

配置AI工具

在Cursor上运行（STDIO）

配置Cursor 🖥️

要在Cursor中配置Mem0 MCP：

1. 打开Cursor设置
2. 转到功能 > MCP服务器
3. 点击“+ 添加新MCP服务器”
4. 输入以下内容：
   • 名称：“mem0-mcp”（或您喜欢的名称）
   • 类型：“命令”
   • 命令：env MEM0_API_KEY=your-api-key-here npx -y @mem0/mcp（或使用此仓库中的start:stdio）

要使用JSON配置来配置Mem0 MCP：

{
  "mcpServers": {
    "mem0-mcp": {
      "command": "npx",
      "args": ["-y", "@mem0/mcp"],
      "env": {
        "MEM0_API_KEY": "YOUR-API-KEY-HERE"
      }
    }
  }
}

在VS Code上运行（STDIO）

在VS Code的用户设置（JSON）文件中添加以下JSON块：

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "apiKey",
        "description": "Mem0 API Key",
        "password": true
      }
    ],
    "servers": {
      "mem0-memory": {
        "command": "npx",
        "args": ["-y", "@mem0/mcp"],
        "env": {
          "MEM0_API_KEY": "${input:apiKey}"
        }
      }
    }
  }
}

可用工具

1. 添加记忆工具（add-memory）

使用用户特定的上下文存储新的记忆。

{
  "name": "add-memory",
  "arguments": {
    "content": "用户偏好暗模式界面",
    "userId": "user123"
  }
}

2. 搜索记忆工具（search-memories）

搜索存储的记忆以检索相关信息。

{
  "name": "search-memories",
  "arguments": {
    "query": "用户的界面偏好是什么？",
    "userId": "user123"
  }
}

响应格式

添加记忆响应

{
  "content": [
    {
      "type": "text",
      "text": "记忆已成功添加"
    }
  ],
  "isError": false
}

搜索记忆响应

{
  "content": [
    {
      "type": "text",
      "text": "记忆：用户偏好暗模式界面\n相关性：0.95\n---\n记忆：用户提到喜欢极简UI\n相关性：0.82\n---"
    }
  ],
  "isError": false
}

配置

环境变量

• MEM0_API_KEY：您的Mem0 API密钥（必需）
  • 运行所需
  • 可从Mem0仪表板获取

开发

先决条件

• Node.js >= 18
• 一个Mem0 API密钥

设置

1. 安装依赖项：

npm install

2. 可选地，在项目目录中创建一个.env文件，并添加您的Mem0 API密钥：

MEM0_API_KEY=your-api-key-here
DEFAULT_USER_ID=mem0-mcp-user

HTTP/StreamableHTTP开发

npm run dev

STDIO开发

npm run build:stdio
npm run start:stdio

错误处理

服务器包括对以下情况的错误处理：

• API连接问题
• 无效的记忆操作
• 搜索错误
• 认证失败

示例错误响应：

{
  "content": [
    {
      "type": "text",
      "text": "错误：搜索记忆失败：无效的API密钥"
    }
  ],
  "isError": true
}

贡献

欢迎贡献！请随时提交拉取请求。

许可证

MIT