关键词

AI记忆持久化记忆LLM增强对话记忆上下文管理

使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 构建的后端服务器，专注于为大型语言模型提供强大的、跨会话的持久化记忆功能。通过与兼容 MCP 协议的客户端（如 Claude Desktop）集成，本服务器能够自动捕获、存储和检索用户的偏好、事实、对话历史等信息，使 LLM 具备更自然的记忆能力，从而提升用户体验和会话的连贯性。

主要功能点

  • 分层记忆架构: 将记忆分为短期、长期和归档不同层级。
  • 多种记忆类型: 支持存储对话、事实、实体、反思等多种类型的记忆。
  • 语义搜索: 能够通过语义相似度检索相关的记忆信息。
  • 自动记忆管理: 无需用户显式指令，服务器可智能判断并捕获重要信息进行存储。
  • 记忆整合: 自动将短期记忆整合到长期记忆中。
  • 记忆维护: 基于重要性进行记忆的保留和遗忘。
  • Claude 集成: 提供与 Claude Desktop 应用直接集成的能力。
  • MCP 协议支持: 完全兼容 Model Context Protocol。
  • Docker 部署: 支持使用 Docker 容器轻松部署。

安装步骤

方法一：使用 Docker（推荐）

  1. 克隆仓库： 
    git clone https://github.com/WhenMoon-afk/claude-memory-mcp.git
cd claude-memory-mcp
  2. 使用 Docker Compose 启动： 
    docker-compose up -d
  3. 配置 Claude Desktop 连接到 Docker 容器运行的 MCP 服务器。

方法二：标准安装

  1. 确保已安装 Python 3.8 - 3.12 和 pip 包管理器。
  2. 克隆仓库： 
    git clone https://github.com/WhenMoon-afk/claude-memory-mcp.git
cd claude-memory-mcp
  3. 安装依赖： 
    pip install -r requirements.txt
  4. 运行安装脚本： 
    chmod +x setup.sh
./setup.sh
  5. 配置 MCP 客户端（如 Claude Desktop）以启动该服务器。

服务器配置

要让兼容 MCP 的客户端（如 Claude Desktop）使用此记忆服务器，您需要将服务器的启动信息添加到客户端的配置中。通常在一个 JSON 配置文件中进行设置，例如命名为 'claude_config.json'。

以下是一个示例配置片段，您需要将其添加到客户端的 MCP 服务器列表中：

{
  "mcpServers": {
    "memory": {
      "command": "python",  // 启动服务器的命令，这里是执行Python模块
      "args": ["-m", "memory_mcp"], // 传递给命令的参数，这里是指定运行 memory_mcp 模块
      "env": {
        // 可选的环境变量配置，例如指定记忆文件路径
        "MEMORY_FILE_PATH": "/path/to/your/memory.json" 
      }
    }
    // 如果有其他MCP服务器，可以在这里添加
  }
}

配置说明：

  • '"memory"': 这是您为这个 MCP 服务器指定的内部名称，可以自定义。
  • '"command"': 客户端用来启动 MCP 服务器进程的命令。对于标准安装，通常是 '"python"'。
  • '"args"': 传递给 'command' 的参数列表。'["-m", "memory_mcp"]' 表示以模块方式运行 'memory_mcp'（即启动服务器）。您可以在这里添加服务器支持的命令行参数，例如用于指定配置文件的 '--config /path/to/your/config.json' 或用于指定记忆文件路径的 '--memory-file /path/to/your/memory.json'。
  • '"env"': (可选) 设置 MCP 服务器进程所需的环境变量。'"MEMORY_FILE_PATH"' 变量可以用来覆盖配置文件中或默认的记忆文件存储位置。

请根据您的实际安装方式（标准安装或 Docker）和偏好调整 'command' 和 'args' 参数，并确保'/path/to/your/memory.json' 替换为您希望存储记忆文件的实际路径。

基本使用方法

配置完成后，当您使用兼容的 LLM 客户端进行对话时，本记忆服务器将在后台工作。

  1. 自动记忆: LLM 会自动识别对话中的重要信息（如您的偏好、分享的事实、个人信息），并将其存储到记忆库中。您无需说出“请记住...”之类的指令。
  2. 自动回忆: 在新的会话开始或对话过程中，LLM 会根据当前话题自动检索记忆库中相关的信息，并在回复中自然地引用这些记忆，使对话更个性化和连贯。
  3. 查询记忆: 您可以直接问 LLM 关于它记住的内容，例如：“你记得我提过什么偏好吗？” 或 “你对我了解多少？”。LLM 会调用内部工具查询记忆库并回答您。

为了获得最佳体验，建议将 README 中提供的系统提示添加到您的 LLM 客户端配置中，指导 LLM 如何更好地利用记忆功能。

This Claude instance has been enhanced with persistent memory capabilities.
Claude will automatically remember important details about you across
conversations and recall them when relevant, without needing explicit commands.

信息

分类

AI与计算

访问项目