AI导哈

AI代理持久内存存储

一个基于SQLite的MCP服务器，为AI代理提供持久化内存存储和全文搜索功能。

  • by haksndot
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 haksndot/haksnbot-memory

使用说明

haksnbot内存

为AI代理提供持久内存存储的MCP（模型上下文协议）服务器。使用SQLite进行全文搜索，以高效存储和检索内存。

Haksnbot套件的一部分： 该项目最初是作为 Haksnbot，一个自主的Minecraft机器人。该套件包括四个协同工作的仓库： haksnbot工具 （Minecraft机器人控制）， haksnbot头脑 （自主代理）， haksnbot管理员 （服务器管理），以及 haksnbot内存 （这个repo-持久内存）。每个都可以独立使用，但它们被设计为协同工作。

特性

  • 持久化存储 -记忆存活代理重新启动
  • 全文搜索 -使用FTS5按内容查找记忆
  • 标签系统 -使用灵活的标签组织记忆
  • 重要性级别 -优先考虑重要记忆
  • 分页 -高效处理大型内存收集

安装

git clone https://github.com/haksndot/haksnbot-memory.git
cd haksnbot-memory
npm install

使用Claude代码

添加到您的Claude Code MCP设置中(~/.claude/settings.json):

{
  "mcpServers": {
    "memory": {
      "command": "node",
      "args": ["/path/to/haksnbot-memory/src/index.js"]
    }
  }
}

配置

数据库路径可以通过环境变量设置：

{
  "mcpServers": {
    "memory": {
      "command": "node",
      "args": ["/path/to/haksnbot-memory/src/index.js"],
      "env": {
        "MEMORY_DB_PATH": "/path/to/memories.db"
      }
    }
  }
}

如果未设置，则默认为 memories.db 在包目录中。

可用工具

工具 说明
create_memory 使用可选标签、上下文和重要性存储新内存
get_memory 按ID检索特定内存
update_memory 更新现有内存的内容、标签或重要性
delete_memory 删除内存
list_memories 列出具有过滤、排序和分页功能的内存
search_memories 跨内存内容、标签和上下文的全文搜索
get_memory_stats 获取统计数据：总计数、标签分布、日期范围

存储结构

每个内存包含：

  • 内容 -主存储器文本（必填）
  • 标签 -分类标签阵列（例如。， ["player:Steve", "event:trade"])
  • 上下文 -关于内存创建时间/地点的其他上下文
  • 重要性 -优先级1-10（默认值5）
  • created_at / updated_at -时间戳

例子

> Remember that Steve helped me find diamonds at coordinates -234, 12, 567

> Search my memories for anything about Steve

> List my most important memories (importance >= 8)

> What do I remember about trading?

需求

  • Node.js 18+

依赖项

相关项目

许可证

麻省理工学院

相关 MCP