MCP Memory Server

MCP Memory Server

概述

MCP Memory Server 是一个正在开发中的开源项目，使用 Golang 和 Upstash 的向量数据库提供记忆存储、检索和管理系统。它提供简单的 HTTP API，供 AI 助手存储和检索上下文信息。

该项目实现了 MCP（Model Control Protocol）规范，使 AI 模型能够以标准化的方式与外部工具交互。

功能

目前，该项目仍在开发中，已实现三种核心 API 方法：

1. 存储记忆 - 保存信息并自动生成向量嵌入
2. 检索记忆 - 使用自然语言查询语义搜索相关信息
3. 删除记忆 - 根据 ID 删除特定记忆

技术栈

• 后端：Go（Golang）
• 向量数据库：目前支持 Upstash Vector
• 传输方式：HTTP API

入门指南

安装

1. 克隆代码仓库

   git clone https://github.com/bqx619/mcp-memory-server.git
   cd mcp-memory-server
   

2. 安装依赖项

   go mod download
   

3. 创建包含以下变量的 .env 文件：

   VECTOR_PROVIDER=upstash
   VECTOR_URL=your-upstash-vector-url
   VECTOR_TOKEN=your-upstash-vector-token
   HTTP_PORT=8080
   

运行服务

go run .

服务将在配置的端口上启动（默认：8080）。

API 参考

存储记忆

将新信息存储到向量数据库中。

端点：POST /tools/store_memory 请求体：

{
  "content": "Memory content to store"
}

响应：

{
  "content": "Successfully stored memory with ID: abcd1234"
}

检索记忆

根据查询执行语义搜索，查找相关信息。

端点：POST /tools/retrieve_memory 请求体：

{
  "query": "search term",
  "n_results": 5
}

响应：

{
  "content": "Found the following memories:
Memory 1:
Content: The first relevant memory
Id: abcd1234
Relevance Score: 0.92
Memory 2:
Content: Another related memory
Id: efgh5678
Relevance Score: 0.85
..."
}

删除记忆

根据 ID 删除特定记忆。

端点：POST /tools/delete_memory 请求体：

{
  "memory_id": "abcd1234"
}

响应：

{
  "content": "Successfully deleted memory with ID: abcd1234"
}

开发路线图

• 添加身份验证
• 实现记忆标记和分类
• 支持更多向量数据库提供商
• 增强搜索功能
• 添加记忆过期和 TTL 功能
• ...

参与贡献

由于该项目目前仍在开发中，欢迎贡献。欢迎提交问题和拉取请求。