MCP Memory Service

MCP记忆服务是一个基于ChromaDB和句子转换器的语义记忆存储系统，为Claude Desktop提供长期记忆和语义搜索功能。

知识管理与记忆人工智能聊天机器人 #语义记忆 #持久存储 #智能搜索 #多平台 .Python

评分 : 3.5分

下载量 : 259

更新时间 : 2025-04-29

什么是MCP内存服务？

MCP内存服务是一个提供语义记忆和持久存储能力的MCP服务器，适用于长期记忆存储和跨对话实例的上下文维护。它利用ChromaDB和sentence transformers实现高效的语义搜索。

如何使用MCP内存服务？

只需几步即可完成安装和配置，通过存储、检索和管理记忆来增强对话体验。

适用场景

适用于需要长期记忆存储的应用场景，例如个人助理、客服系统和教育工具。

主要功能

语义搜索通过句子转换器模型实现高效语义记忆检索。

自然语言时间回忆使用自然语言表达的时间（如“上周”、“昨天上午”）进行记忆检索。

标签记忆检索通过特定标签查找记忆。

持久存储使用ChromaDB进行持久化存储。

自动数据库备份定期备份数据库以确保数据安全。

记忆优化工具清理重复项并优化数据库性能。

精确匹配检索通过完全匹配内容检索记忆。

调试模式分析相似度并查看检索过程。

数据库健康监控检查数据库运行状态并获取统计信息。

去重清理自动检测并删除重复条目。

自定义嵌入模型支持选择不同的嵌入模型。

跨平台兼容性支持多种操作系统和硬件架构。

硬件感知优化根据不同环境调整优化策略。

优雅降级在资源受限时提供备用方案。

优势与局限性

优势

强大的语义搜索能力。

支持多种记忆检索方式（时间、标签、精确匹配等）。

自动备份和去重功能减少人工干预。

跨平台兼容性强，适配不同硬件架构。

硬件感知优化确保最佳性能。

局限性

对大型数据库可能需要更多计算资源。

某些高级功能依赖于网络连接。

初次部署可能需要一定的技术背景。

如何使用

安装UV

确保已安装UV工具。

克隆并安装服务

克隆项目并完成安装。

启动服务

运行服务开始使用。

使用案例

存储记忆向MCP内存服务存储一条新的记忆。

检索记忆通过关键词检索存储的记忆。

常见问题

如何检查服务是否正常运行？

如何清理重复记忆？

如何设置自动备份？

🚀 MCP 内存存储

MCP 内存存储是一个借助云flare 工作器实现的内存服务，它基于云flare 工作器和 D1 数据库，提供了一套用于存储、检索和管理记忆内容的解决方案，能有效解决记忆数据的存储与管理难题，为用户提供便捷、高效的服务。

🚀 快速开始

配置指南

1. 克隆代码仓库并进入云flare 工作器目录

git clone https://github.com/doobidoo/mcp-memory-service.git
cd mcp-memory-service/cloudflare_worker

2. 安装 Wrangler CLI 工具

Wrangler 是云flare 提供的命令行工具，用于管理和部署工作器。

npm install -g wrangler

3. 登录云flare 账户

使用安装好的 Wrangler 登录你的云flare 账户。

wrangler login

4. 创建 D1 数据库

在云flare 平台创建一个新的 D1 数据库实例。

wrangler d1 create mcp_memory_service

5. 更新 wrangler.toml 配置文件

根据创建的数据库 ID 更新 wrangler.toml 文件中的数据库配置。

✨ 主要特性

核心组件

Cloudflare Workers：负责处理 HTTP 请求和响应。
D1 数据库：用于持久化存储记忆数据，支持 SQLite 风格的查询。
Workers AI：集成 AI 模型进行内容分析和向量化。
Server - Sent Events (SSE)：实现与 MCP 协议的兼容。

核心功能

工具	描述
`store_memory`	存储新的记忆内容，支持可选标签。
`retrieve_memory`	根据查询检索相关记忆内容。
`recall_memory`	使用自然语言的时间表达式检索记忆。
`search_by_tag`	按标签搜索记忆内容。
`delete_memory`	根据哈希删除特定记忆。
`delete_by_tag`	删除所有带有指定标签的记忆。
`cleanup_duplicates`	识别并删除重复记忆条目。
`get_embedding`	获取内容的原始嵌入向量。
`check_embedding_model`	检查嵌入模型是否加载并正常工作。
`debug_retrieve`	带有调试信息检索记忆。
`exact_match_retrieve`	使用精确内容匹配检索记忆。
`check_database_health`	检查数据库健康状态和获取统计信息。
`recall_by_timeframe`	根据时间范围检索记忆内容。
`delete_by_timeframe`	删除指定时间段内的记忆内容。
`delete_before_date`	删除指定日期之前的所有记忆内容。