MCP Memory Service

MCP記憶服務是一個基於ChromaDB和句子轉換器的語義記憶存儲系統，為Claude Desktop提供長期記憶和語義搜索功能。

知識管理與記憶人工智能聊天機器人 #語義記憶 #持久存儲 #智能搜索 #多平臺 .Python

評分 : 3.5分

下載量 : 256

更新時間 : 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`	刪除指定日期之前的所有記憶內容。