使用说明
项目简介
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 暴露所有功能,实现无缝集成。
- 自动会话: 自动创建新会话,确保对话上下文不丢失。
- 错误处理: 具备完善的错误处理机制,提升系统稳定性。
安装步骤
- 克隆仓库
git clone https://github.com/mushroomfleet/ltm-cline.git cd ltm-cline - 安装依赖
npm install - 构建项目
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 项目在您本地文件系统中的绝对路径。
基本使用方法
-
启动 MCP 服务器: 在 LTM-CLINE 项目目录下,运行以下命令启动 MCP 服务器:
node src/mcp/server.js服务器成功启动后,会在控制台输出 'LTM-CLINE MCP server running on stdio' 信息。
-
配置 MCP 客户端: 打开 Cline VSCode 扩展的设置,编辑 'cline_mcp_settings.json' 文件,添加或修改上述服务器配置信息,并确保配置中的路径正确。
-
重启 Cline VSCode 扩展: 重启 Cline VSCode 扩展,使其加载新的 MCP 服务器配置。
-
在 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与计算