关键词

LLM记忆语义搜索对话历史上下文管理开发协作

项目简介

Episodic Memory 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为 LLM（如 Claude Code）提供长期记忆能力。它通过索引用户与 LLM 的历史对话，并允许 LLM 进行语义搜索和内容回顾，从而提升 LLM 在复杂代码库协作中的连续性和效率。

主要功能点

  • 对话索引与归档: 自动将 Claude Code 会话归档到本地，并创建向量和文本索引，支持语义搜索和精确文本匹配。
  • 语义搜索: 允许 LLM 对历史对话进行语义搜索，查找相关讨论、决策和模式，支持单个概念或多个概念（AND 逻辑）的查询，并可指定日期范围和结果数量。
  • 对话内容显示: 提供工具以供 LLM 根据文件路径和可选的行号范围获取并显示完整的历史对话内容，支持 Markdown 和 HTML 格式输出，方便详细查阅。
  • 上下文保留: 帮助 LLM 记住过去的决策原因、技术权衡和用户偏好，避免在会话间重复解释上下文，提高开发效率。

安装步骤

  1. 作为 Claude Code 插件 (推荐): 在 Claude Code 的终端中运行以下命令：

    /plugin install episodic-memory@superpowers-marketplace

    插件会自动处理依赖安装、索引初始化以及与 Claude Code 的无缝集成。

  2. 作为 npm 包 (用于手动管理或集成到其他 MCP 客户端): 在您的终端中运行以下命令安装：

    npm install episodic-memory

    然后，您需要根据“服务器配置”部分手动启动 MCP 服务器。

服务器配置 (MCP 客户端用)

MCP 客户端需要配置以下信息才能连接到 Episodic Memory MCP 服务器：

{
  "name": "episodic-memory",
  "command": "episodic-memory-mcp-server",
  "args": []
}

参数说明:

  • 'name': 服务器的唯一标识符，建议保持为 'episodic-memory'。
  • 'command': 启动 MCP 服务器的可执行命令，'episodic-memory-mcp-server' 是该仓库提供的跨平台包装器脚本，它会在首次运行时自动检查并安装必要的依赖项，然后启动实际的 MCP 服务器。
  • 'args': 传递给服务器启动命令的额外参数，目前不需要任何额外参数，因此留空。

基本使用方法

  • 作为 Claude Code 插件使用:
    • 自动索引: 插件会在每个会话结束时自动将对话内容同步到本地并建立索引。
    • 搜索命令: 在 Claude Code 的对话框中，您可以使用 '/search-conversations' 命令显式地搜索历史对话。
    • 自然语言交互: 在与 Claude 交流时，当需要参考过去的工作或做出新的决策时，Claude 会在适当的时候自动调用 Episodic Memory 的搜索功能来恢复上下文。
  • 手动命令行使用 (适用于直接安装 npm 包的情况):
    • 同步并索引对话: 
      episodic-memory sync
    • 搜索历史对话: 
      episodic-memory search "React Router authentication"
    • 查看索引统计: 
      episodic-memory stats
    • 显示特定对话内容: 
      episodic-memory show path/to/conversation.jsonl

信息

分类

AI与计算

访问项目