AI导哈

代理记忆管理服务

一个基于LanceDB的本地代理记忆管理服务，提供混合BM25和向量搜索功能，支持跨会话存储、搜索和管理AI代理的记忆。

  • by adamrdrew
  • TypeScript
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 adamrdrew/agent-memory-mcp

使用说明

代理存储器mcp

用于持久代理内存的MCP服务器，由 兰斯数据库 使用混合BM25+矢量搜索。使AI代理能够使用 模型上下文协议.

所有数据都保留在您的机器上。嵌入是使用以下命令在本地生成的 全迷你LM-L6-v2 通过ONNX-无API密钥，初始设置后无网络依赖性。

特性

  • 混合搜索 --通过互易秩融合（RRF）将BM25全文搜索与余弦向量相似性相结合
  • 本地嵌入 -通过ONNX本地运行Xenova/all-MiniLM-L6-v2，无外部API调用
  • 12个存储类别 --组织记忆的结构化分类法
  • 批量操作 --在一次通话中存储多个存储器
  • 硬拷贝备份 --用于人类可读备份的所有突变的可选JSON文件镜像
  • 时间衰减 --当相关性相似时，基于时间的指数衰减有利于最近的记忆。可配置的半衰期，具有 evergreen 和 never-forget 标签豁免
  • 完全本地化 --所有数据都保留在磁盘上，在首次下载模型后没有网络依赖关系

安装

首先全局安装该包。这将下载嵌入模型（约80 MB），以便在服务器启动时准备就绪：

npm install -g @adamrdrew/agent-memory-mcp

然后将服务器添加到MCP客户端配置中。

克劳德桌面版

增添 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "agent-memory": {
      "command": "agent-memory-mcp",
      "env": {
        "MEMORY_DB_PATH": "/path/to/your/memory-db"
      }
    }
  }
}

克劳德代码

添加到您的项目 .mcp.json:

{
  "agent-memory": {
    "command": "agent-memory-mcp",
    "env": {
      "MEMORY_DB_PATH": "/path/to/your/memory-db"
    }
  }
}

配置

变量 必填 描述
MEMORY_DB_PATH 是 LanceDB数据库目录的路径
EMBEDDING_MODEL 否 拥抱脸模型ID（默认值： Xenova/all-MiniLM-L6-v2)
MEMORY_DECAY_HALF_LIFE 否 衰变半衰期（以天为单位）（默认值： 30).设置为 0 禁用时间衰减
ENABLE_HARDCOPY 否 设置为 true 启用JSON文件备份
HARDCOPY_PATH 如果启用了硬拷贝 JSON镜像文件的目录

工具

工具 说明
store 存储包含内容、类别和标签的单个内存
store_batch 在一次通话中存储多个记忆
search 按含义和/或关键字搜索记忆。支持混合、关键字和语义模式
recall 多主题情境回忆——并行搜索多个主题，包括最近的记忆
find_related 查找与特定记忆相似的记忆
list_recent 列出最近的记忆，可选择按类别筛选
update 更新现有内存——如果内容发生变化，则自动重新嵌入
delete 按ID永久删除内存
stats 获取数据库统计信息：总计数、按类别细分、时间戳

搜索模式

这 search 该工具支持三种模式：

  • hybrid （默认）--使用RRF重新排序将BM25关键字评分与向量相似性相结合。仅当全文索引不可用时，才返回语义。
  • keyword --仅限BM25全文搜索。
  • semantic --仅余弦向量相似性。

所有模式都支持按类别、标签和日期范围进行过滤。

时间衰退

搜索结果以基于时间的指数衰减进行评分，这样当语义相关性相似时，最近的记忆就会出现在较旧的记忆之上。衰变遵循半衰期模型：一个半衰期的记忆得分减半，两个半衰期的记忆力得分减半，以此类推。

  • 默认半衰期：30天（可通过配置 MEMORY_DECAY_HALF_LIFE)
  • 禁用：set MEMORY_DECAY_HALF_LIFE=0
  • 豁免标签：已标记记忆 evergreen 或 never-forget 永不腐烂

内存类别

code-solution · bug-fix · architecture · learning · tool-usage · debugging · performance · security · observation · personal · relationship · other

发展

git clone https://github.com/adamrdrew/agent-memory-mcp.git
cd agent-memory-mcp
npm install
npm run dev          # Run with tsx (no build step)
npm run build        # Compile TypeScript to dist/
npm test             # Run all tests
npm run test:watch   # Run tests in watch mode

许可证

该项目根据 GNU通用公共许可证v3.0.

相关 MCP