AI导哈

内存存储检索服务器

一个基于Model Context Protocol (MCP)的内存存储和检索服务器，支持存储和搜索记忆，适用于上下文维护和基于历史交互的决策。

  • by mem0ai
  • Python
  • 本地部署
  • 662 星标
  • 更新于
在 GitHub 查看 mem0ai/mem0-mcp

使用说明

Mem0内存MCP服务器

一种模型上下文协议（MCP）服务器，通过以下方式提供内存存储和检索功能 Mem0。此工具允许您存储和搜索记忆，使其有助于维护上下文并根据过去的交互做出明智的决策。

特性

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

用法

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

流式HTTP（推荐）

  • 开发（打开Smithery Playground并公开HTTP传输）：
npm run dev
  • 构建HTTP/StreamableHTTP（Smithery）：
npm run build
  • 在本地启动HTTP服务器（Smithery构建的入口点）：
npm run start:http

您可以在操场上使用Smithery生成的表单或通过设置环境变量（例如。， MEM0_API_KEY).

STDIO（向后兼容）

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

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

AI工具的配置

在游标上运行（STDIO）

配置光标🖥️

要在游标中配置Mem0 MCP：

  1. 打开光标设置
  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代码（STDIO）上运行

将以下JSON块添加到VS Code中的用户设置（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.添加内存工具（添加内存）

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

{
  "name": "add-memory",
  "arguments": {
    "content": "User prefers dark mode interface",
    "userId": "user123"
  }
}

2.搜索记忆工具（搜索记忆）

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

{
  "name": "search-memories",
  "arguments": {
    "query": "What are the user's interface preferences?",
    "userId": "user123"
  }
}

响应格式

添加内存响应

{
  "content": [
    {
      "type": "text",
      "text": "Memory added successfully"
    }
  ],
  "isError": false
}

搜索内存响应

{
  "content": [
    {
      "type": "text",
      "text": "Memory: User prefers dark mode interface\nRelevance: 0.95\n---\nMemory: User mentioned liking minimal UI\nRelevance: 0.82\n---"
    }
  ],
  "isError": false
}

配置

环境变量

  • MEM0_API_KEY：您的Mem0 API密钥（必需）

发展

先决条件

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

设置

  1. 安装依赖项：
npm install
  1. 可选择创建 .env 文件，并添加您的Mem0 API密钥：
MEM0_API_KEY=your-api-key-here
DEFAULT_USER_ID=mem0-mcp-user

HTTP/流式HTTP开发

npm run dev

STDIO开发

npm run build:stdio
npm run start:stdio

错误处理

服务器包括以下错误处理：

  • API连接问题
  • 无效的内存操作
  • 搜索错误
  • 身份验证失败

错误响应示例：

{
  "content": [
    {
      "type": "text",
      "text": "Error: Failed to search memories: Invalid API key"
    }
  ],
  "isError": true
}

贡献

欢迎投稿！请随时提交拉取请求。

许可证

麻省理工学院

相关 MCP