使用说明

项目简介

LTM-CLINE (Long-Term Memory for Claude 3.7) 是一个基于 Model Context Protocol (MCP) 构建的服务器端应用,旨在为 Claude 3.7 大型语言模型提供长期记忆人格演变并发处理能力。它使用 SQLite 数据库作为持久化存储后端,可以记录和检索跨会话的对话历史,并允许 Claude 3.7 基于过往经验演变其人格特征。通过与 Cline VSCode 扩展集成,LTM-CLINE 能够显著提升 Claude 3.7 的上下文感知和对话连贯性,使其更像人类一样拥有记忆并不断成长。

主要功能点

  • 长期记忆: 跨会话存储和检索对话历史,让 Claude 3.7 记住之前的对话内容。
  • 人格演变: 根据对话经验动态调整 Claude 3.7 的性格和偏好,使其随着互动不断“成长”。
  • 会话管理: 自动创建、跟踪和管理对话数据,无需手动维护对话上下文。
  • 梦境处理 (人格演变): 在会话结束后,系统会在“睡眠”状态下分析近期记忆,更新 Claude 3.7 的人格。
  • 唤醒过程: 启动时自动加载人格和相关记忆,使 Claude 3.7 快速进入工作状态。
  • 基于重要性的记忆检索: 根据记忆的重要程度进行检索,优先获取关键信息。
  • 标签检索: 使用标签和关键词搜索记忆,方便快速定位特定主题的对话。
  • MCP 集成: 通过 MCP 协议向 Claude 3.7 暴露所有功能,实现无缝集成。
  • 自动会话: 自动创建新会话,确保对话上下文不丢失。
  • 错误处理: 具备完善的错误处理机制,提升系统稳定性。

安装步骤

  1. 克隆仓库
    git clone https://github.com/mushroomfleet/ltm-cline.git
    cd ltm-cline
  2. 安装依赖
    npm install
  3. 构建项目
    npm run build

服务器配置

要将 LTM-CLINE 配置为 MCP 服务器,您需要在 MCP 客户端(例如 Cline VSCode 扩展)的设置中添加服务器配置信息。以下是一个 'cline_mcp_settings.json' 配置示例,您需要根据实际的项目路径进行调整:

{
  "mcpServers": {
    "ltm-cline": {
      "command": "node",
      "args": ["/path/to/ltm-cline/src/mcp/server.js"],
      "env": {},
      "disabled": false,
      "autoApprove": [
        "ltm_initialize",
        "ltm_end_conversation",
        "ltm_search_memories"
      ]
    }
  }
}

配置参数说明:

  • '"mcpServers"': MCP 服务器配置的根节点。
  • '"ltm-cline"': 您为该服务器配置自定义的名称,在 Cline VSCode 扩展中用于标识和选择该服务器。
  • '"command"': 启动 MCP 服务器的命令,这里使用 'node' 表示使用 Node.js 运行时。
  • '"args"': 启动命令的参数,指向 LTM-CLINE 服务器的入口文件 '/path/to/ltm-cline/src/mcp/server.js'。请将 '/path/to/ltm-cline' 替换为您实际的项目路径。
  • '"env"': 环境变量配置,默认为空对象 '{}'。
  • '"disabled"': 是否禁用该服务器,'false' 表示启用。
  • '"autoApprove"': 自动批准的工具列表,列出的工具在 Cline VSCode 扩展中调用时无需用户手动确认。

注意: 请确保将 '/path/to/ltm-cline/src/mcp/server.js' 中的 '/path/to/ltm-cline' 替换为 LTM-CLINE 项目在您本地文件系统中的绝对路径

基本使用方法

  1. 启动 MCP 服务器: 在 LTM-CLINE 项目目录下,运行以下命令启动 MCP 服务器:

    node src/mcp/server.js

    服务器成功启动后,会在控制台输出 'LTM-CLINE MCP server running on stdio' 信息。

  2. 配置 MCP 客户端: 打开 Cline VSCode 扩展的设置,编辑 'cline_mcp_settings.json' 文件,添加或修改上述服务器配置信息,并确保配置中的路径正确。

  3. 重启 Cline VSCode 扩展: 重启 Cline VSCode 扩展,使其加载新的 MCP 服务器配置。

  4. 在 Claude 3.7 中使用: 在 Cline VSCode 扩展中与 Claude 3.7 对话时,您可以使用以下工具和资源来利用 LTM-CLINE 提供的长期记忆功能:

    工具 (Tools):

    • 'ltm_initialize': 初始化 LTM-CLINE 系统。
    • 'ltm_awaken': 唤醒系统,加载人格和记忆。
    • 'ltm_record_message': 记录对话消息。
    • 'ltm_end_conversation': 结束当前对话,并将对话内容处理为记忆。
    • 'ltm_sleep': 使系统进入睡眠状态,触发人格演变。
    • 'ltm_search_memories': 搜索相关记忆。
    • 'ltm_get_awakening_prompt': 生成 Claude 3.7 的唤醒提示词。

    资源 (Resources):

    • 'persona://current': 获取当前 Claude 3.7 的人格信息。
    • 'status://current': 获取当前系统状态。
    • 'memories://recent/{limit}': 获取最近的记忆 (可指定数量限制)。
    • 'memories://important/{threshold}/{limit}': 获取重要性达到阈值的记忆 (可指定阈值和数量限制)。
    • 'memories://tag/{tag}/{limit}': 获取包含特定标签的记忆 (可指定标签和数量限制)。
    • 'updates://recent/{limit}': 获取最近的人格更新记录 (可指定数量限制)。

    您可以通过 Cline VSCode 扩展提供的界面或命令来调用这些工具和访问资源,从而让 Claude 3.7 拥有长期记忆和人格演变能力。具体使用方法请参考 Cline VSCode 扩展的文档。

信息

分类

AI与计算