金大哥 - long-term-memory MCP 详情

article

README

🚀 本地长期记忆系统 (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

使用准则

适合存储的信息：持久且可重复使用的信息，稳定的信息（如偏好、事实、决策）。
不适合存储的信息：临时上下文、特定任务的细节、原始对话文本（除非至关重要）。

添加工具

创建 src/tools/mytool.js 文件。
导出带有模式和执行函数的工具。
在 src/tools/index.js 中注册该工具。

📄 许可证

本项目采用 MIT 许可证。

long-term-memory