Long Term Memory

🚀 本地長期記憶系統 (Local LTM)

這是一個模塊化、本地維護的長期記憶系統，專為人工智能代理設計。它由 Mem0 提供支持，並通過 MCP（模型上下文協議） 對外暴露。該系統可用於存儲、搜索和管理人工智能代理在對話過程中的持久知識。

🚀 快速開始

啟動服務器

node src/index.js

測試

node src/test.js

✨ 主要特性

• 模塊化設計：採用模塊化架構，便於擴展和維護。
• 本地維護：數據在本地存儲和管理，保障數據安全。
• 多類型記憶支持：支持情景記憶、語義記憶和程序記憶。
• 工具豐富：提供存儲、搜索、更新和刪除記憶的工具。

📦 安裝指南

1. 前提條件

• Node.js 16 及以上版本
• Mem0 API 密鑰（點擊獲取）

2. 安裝依賴

npm install

3. 配置環境變量

創建一個 .env 文件，並添加以下內容：

MEM0_API_KEY=your_mem0_api_key_here

更多詳細信息請參考 .env.example 文件。

💻 使用示例

基礎用法

// 存儲記憶
await client.send("tools/call", {
  name: "memory.store",
  arguments: {
    namespace: "/shared",
    content: "User prefers concise explanations",
    type: "procedural",
    confidence: 0.9
  }
});

// 搜索記憶
const results = await client.send("tools/call", {
  name: "memory.search",
  arguments: {
    namespace: "/shared",
    query: "user preferences"
  }
});

📚 詳細文檔

Claude 桌面集成

將以下配置添加到你的 Claude 桌面配置文件中：

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• macOS/Linux：~/.claude_desktop_config.json

{
  "mcpServers": {
    "long-term-memory": {
      "command": "node",
      "args": ["C:\\Users\\YourUsername\\Desktop\\local-ltm\\src\\index.js"],
      "env": {
        "MEM0_API_KEY": "your_mem0_api_key_here"
      }
    }
  }
}

然後重啟 Claude 桌面應用，即可使用長期記憶工具。

可用工具

• memory.store - 保存記憶（語義、情景、程序記憶）
• memory.search - 按命名空間查詢記憶
• memory.update - 更新現有記憶
• memory.delete - 刪除過時的記憶

記憶組織

• 共享知識：

/shared/user_preferences
/shared/facts

• 特定代理：

/agents/{agent_id}/private/heuristics

記憶類型

• 情景記憶：事件、經歷、對話
• 語義記憶：事實、知識、穩定信息
• 程序記憶：偏好、規則、最佳實踐

項目結構

src/
├── index.js           # MCP 服務器
├── mem0.js            # Mem0 API 包裝器
├── test.js            # 測試客戶端
├── config/
│   ├── prompts.js
│   └── server.js
└── tools/
    ├── store.js
    ├── search.js
    ├── update.js
    └── delete.js

使用準則

• 適合存儲的信息：持久且可重複使用的信息，穩定的信息（如偏好、事實、決策）。
• 不適合存儲的信息：臨時上下文、特定任務的細節、原始對話文本（除非至關重要）。

添加工具

1. 創建 src/tools/mytool.js 文件。
2. 導出帶有模式和執行函數的工具。
3. 在 src/tools/index.js 中註冊該工具。

📄 許可證

本項目採用 MIT 許可證。