MCP 内存服务器

此服务器使用 mem0 原则为 AI 助手实现长期记忆功能，由 PostgreSQL 和 pgvector 提供支持，以实现高效的向量相似性搜索。

特性

• 用于向量相似性搜索的 PostgreSQL 和 pgvector
• 使用 BERT 自动生成嵌入
• 用于内存操作的 RESTful API
• 语义搜索功能
• 支持不同类型的记忆（学习、经验等）
• 基于标签的记忆检索
• 记忆的置信度评分
• 用于实时更新的服务器发送事件 (SSE)
• 兼容 Cursor MCP 协议

前提条件

1. 已安装 pgvector 扩展的 PostgreSQL 14+：

# 在您的 PostgreSQL 实例中：
CREATE EXTENSION vector;

2. Node.js 16+

设置

1. 安装依赖项：

npm install

2. 配置环境变量： 将 .env.sample 复制到 .env 并调整值：

cp .env.sample .env

.env 配置示例：

# 使用用户名/密码
DATABASE_URL="postgresql://username:password@localhost:5432/mcp_memory"
PORT=3333

# 使用对等身份验证进行本地开发
DATABASE_URL="postgresql:///mcp_memory"
PORT=3333

3. 初始化数据库：

npm run prisma:migrate

4. 启动服务器：

npm start

对于具有自动重新加载的开发：

npm run dev

与 Cursor 一起使用

在 Cursor 中添加 MCP 服务器

要将内存服务器添加到 Cursor，您需要修改位于 ~/.cursor/mcp.json 的 MCP 配置文件。 将以下配置添加到 mcpServers 对象：

{
  "mcpServers": {
    "memory": {
      "command": "node",
      "args": [
        "/path/to/your/memory/src/server.js"
      ]
    }
  }
}

将 /path/to/your/memory 替换为您的内存服务器安装的实际路径。

例如，如果您将存储库克隆到 /Users/username/workspace/memory，则您的配置将如下所示：

{
  "mcpServers": {
    "memory": {
      "command": "node",
      "args": [
        "/Users/username/workspace/memory/src/server.js"
      ]
    }
  }
}

服务器将在需要时由 Cursor 自动启动。 您可以通过以下方式验证它是否正常工作：

1. 打开 Cursor
2. 内存服务器将在 Cursor 启动时自动启动
3. 您可以通过访问 http://localhost:3333/mcp/v1/health 来检查服务器状态

可用的 MCP 端点

SSE 连接

• 端点: GET /mcp/v1/sse
• 查询参数:
  • subscribe: 要订阅的事件的逗号分隔列表（可选）
• 事件:
  • connected: 在初始连接时发送
  • memory.created: 在创建新记忆时发送
  • memory.updated: 在更新现有记忆时发送

内存操作

1. 创建记忆

POST /mcp/v1/memory
Content-Type: application/json

{
  "type": "learning",
  "content": {
    "topic": "Express.js",
    "details": "Express.js is a web application framework for Node.js"
  },
  "source": "documentation",
  "tags": ["nodejs", "web-framework"],
  "confidence": 0.95
}

2. 搜索记忆

GET /mcp/v1/memory/search?query=web+frameworks&type=learning&tags=nodejs

3. 列出记忆

GET /mcp/v1/memory?type=learning&tags=nodejs,web-framework

健康检查

GET /mcp/v1/health

响应格式

所有 API 响应都遵循标准 MCP 格式：

{
  "status": "success",
  "data": {
    // 响应数据
  }
}

或者对于错误：

{
  "status": "error",
  "error": "错误消息"
}

内存模式

• id：唯一标识符
• type：记忆类型（学习、经验等）
• content：实际记忆内容 (JSON)
• source：记忆的来源
• embedding：内容的向量表示（384 维）
• tags：相关标签数组
• confidence：置信度评分 (0-1)
• createdAt：记忆创建时间
• updatedAt：记忆上次更新时间