MCP Structured Memory

🚀 結構化內存MCP服務器

結構化內存MCP服務器是一個模型上下文協議（MCP）服務器，它通過Markdown文件提供結構化、特定領域的內存管理功能。對於圍繞特定領域展開的正在進行的項目，如果你希望隨著時間的推移積累有價值的上下文信息，那麼這個服務器將非常實用。例如旅行規劃、研究項目、房地產搜索、投資理論、產品規劃和職業發展等特定領域。

🚀 快速開始

安裝

選項1：從npm安裝（發佈後）

npm install -g @nmeierpolys/mcp-structured-memory

選項2：從源代碼安裝

git clone https://github.com/nmeierpolys/mcp-structured-memory.git
cd mcp-structured-memory
npm install
npm run build

配置

對於Claude桌面版

編輯 claude_desktop_config.json 文件，添加以下內容：

{
  "mcpServers": {
    "mcp-structured-memory": {
      "command": "npx",
      "args": ["@nmeierpolys/mcp-structured-memory"]
    }
  }
}

典型使用步驟

1. 要求你的大語言模型（LLM）客戶端為你的特定項目創建一個內存文檔。 示例指令：創建一個新的旅行顧問內存文檔，並告訴我如何使用它。該文檔應初始為空，並隨著時間不斷豐富。
2. 為該領域的對話創建一個新項目，並將提供的使用說明添加到項目上下文中。

   ⚠️ 重要提示

   儘管有工具提示，但大語言模型偶爾可能不會顯示安裝說明。如果發生這種情況，你可以向大語言模型提出顯示安裝說明的請求，它應該會照做。

3. 新的聊天對話會先檢查項目內存中的可用信息。大語言模型會隨著時間更新此內存，以積累有價值的上下文。
4. 你可以根據需要要求大語言模型添加或調整內存文件。此外，要求大語言模型詢問你相關信息也很有幫助，例如：問我一些問題，以瞭解我的旅行偏好。

✨ 主要特性

為何選擇結構化內存

傳統的MCP內存服務器通過語義搜索分散的對話片段。這種方式在一般的信息檢索中表現良好，但對於需要有組織、分類信息的特定項目則效果不佳。

結構化內存則維護具有結構化內容的“動態文檔”，你可以隨時瀏覽、更新和跟蹤這些文檔，就像使用個人筆記本一樣，只不過有了人工智能的協助。

內存文檔以Markdown文件的形式存儲，主要由大語言模型在與你的對話學習過程中自動更新，隨著時間的推移構建豐富的上下文。

靈活的結構

內存文檔支持任何你需要的結構。人工智能將根據你的用例幫助你組織各個部分。常見示例如下：

• 旅行規劃：目的地、行程安排、住宿、活動、餐廳、旅行小貼士、預算跟蹤
• 研究項目：研究問題、文獻綜述、研究方法、研究結果、數據來源、下一步計劃
• 房地產搜索：搜索標準、在售房源、已參觀房產、已拒絕房產、市場洞察、經紀人聯繫方式

自動內存構建示例

用戶：“創建一個新的明尼蘇達之旅內存文檔，並告訴我如何使用它。該文檔應初始為空，並隨著時間不斷豐富。”

Claude：“我已為你的明尼蘇達之旅創建了一個旅行內存文檔。在我們討論你的計劃時，我會自動用目的地、時間安排、偏好以及我瞭解到的關於你旅行的其他細節更新它。”

用戶：“我想欣賞秋天的景色、徒步旅行、品嚐當地美食，並遊覽北岸和雙子城。”

Claude：“我已在內存中記錄了你的優先事項：欣賞秋天的樹葉、徒步旅行機會、當地餐廳、北岸目的地和雙子城景點。在我們探索各種選擇時，我會跟蹤具體的推薦。”

[後續對話]
用戶：“哪些徒步小徑的秋天景色很美？”

Claude：“根據我們之前的討論，我知道你關注明尼蘇達的秋天景色。讓我推薦一些小徑，並將最佳的小徑添加到你的旅行內存中……”

備份和版本控制

服務器會在進行重大更新之前自動創建帶時間戳的備份。

存儲位置

內存文檔文件以Markdown文件的形式存儲在以下位置：

• macOS：~/Library/Application Support/mcp-structured-memory/
• Windows：%LOCALAPPDATA%\mcp-structured-memory\
• Linux：~/.local/share/mcp-structured-memory/

💻 使用示例

可用工具

• create_memory - 創建一個新的內存文檔，可選擇添加初始內容
• list_memories - 列出所有可用的內存文檔
• get_memory_summary - 獲取內存文檔的高級摘要
• get_section - 從內存文檔中檢索特定部分
• get_full_memory - 檢索內存文檔的完整內容
• search_within_memory - 在內存文檔中搜索信息
• update_section - 更新內存文檔的整個部分
• add_to_list - 向列表部分添加一個項目
• update_list_item - 更新列表中的現有項目
• move_list_item - 在列表部分之間移動項目