Memory By File

🚀 mcp-server-memory

這是一個與記憶文本文件交互的 MCP 服務器，旨在幫助 Claude 在聊天過程中保持上下文。每一行記憶文本都代表一段獨立的記憶。

🚀 快速開始

本服務器提供了一系列工具，允許 Claude（以及其他 MCP 客戶端）在聊天時管理記憶：

• memory_add(memory: string)：用於添加記憶。
• memory_search(query: string)：返回匹配的記憶（採用子字符串精確匹配，未來可能支持通配符/正則表達式）。
• memory_delete(query: string)：刪除匹配的記憶（子字符串精確匹配）。
• memory_list()：返回所有記憶。
• 提示：memory_update 相當於 memory_delete 和 memory_add 的組合操作。

💻 使用示例

以下是一些使用示例，展示如何在實際聊天中運用這些記憶管理工具：

基礎用法

• 當提及自己的名字時，可添加記憶："正在與 Wes 聊天"。
• 提到女兒的年齡時，添加記憶："Wes 的女兒 8 歲"。
• 表示正在進行一個 TypeScript 項目時，添加記憶："正在做 TypeScript 項目"。
• 若 Claude 在使用工具過程中遇到情況，例如第一次嘗試使用 python 命令失敗，後續使用 python3 成功，Claude 可以記錄："使用 python3，python 不存在"。

高級用法

• 若要刪除關於 X 的記憶，可使用：memory_delete(query: X)。
• 若要糾正自己的名字，可先使用 memory_search("oldname") 查找舊名字的記憶，刪除匹配記錄，再添加新名字的記憶。

當開始新的聊天時，Claude 會自動獲取最近的記憶（子集或全部），也可以手動請求記憶（部分、更多或全部），並根據這些記憶影響回應和工具的使用。

🔧 技術細節

設計思路

採用簡單的記憶文本文件，主要基於以下原因：

• ChatGPT 的記憶功能運行良好，本質上也是一個文本文件。雖然背後可能存在一些結構化處理，但從用戶視角看，呈現為文本文件形式。
• 在 mcp-server-commands 類似提醒功能的測試中，使用文本文件效果良好（當時 Claude 具備這些功能）。
• 未結構化的文本簡化了工具的操作和參數，基本只需管理一個字符串列表。

提示機制

為了讓模型知道何時存儲記憶，提示機制至關重要。目前有以下幾種實現思路：

• 培訓：OpenAI 表明，部分經過訓練的模型能夠了解何時存儲記憶，就像模型接受工具使用的訓練一樣。
• 提示詞：在系統提示部分添加提醒，以觸發模型存儲記憶。
• 工具本身：在對 Claude 的測試中，僅依靠工具規範和工具響應中的提示/建議，Claude 無法有效存儲記憶。因此，在提示中添加提示信息可能是有效的解決方案。

📚 詳細文檔

未完成的想法

以下是一些未來可能實現的想法，但不確定是否值得投入時間，列出這些想法也是為了避免自己分心去實現它們：

• 新穎性因素：是否可以根據記憶的新穎性重新排列記憶？這樣在處理模糊的記憶查詢時（例如同時提到 TypeScript 項目和 Python 項目，當要求開始新項目時，優先建議最近使用的項目），能提供更準確的建議。
• 逐漸淡出舊記憶：考慮是否需要讓舊記憶逐漸淡出，以保持記憶的時效性和相關性。