AI导哈

记忆数据库工具

一个改进版的记忆数据库工具，提供全文搜索和Python数据导入功能，适用于知识管理和会话记录。

  • by Im-Hal-9K
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Im-Hal-9K/claude-memory-tools

使用说明

克劳德记忆工具

一个分叉和改进的版本 @当月亮afk/记忆mcp 更好的FTS5搜索，以及用于将数据导入内存数据库的Python实用程序。

与上游有何不同

上游MCP将搜索查询直接传递给SQLite FTS5，无需预处理。FTS5的默认运算符是AND，因此查询如下 "bonsai tree plant care" 需要 全部四个单词 在单个内存中，即使存在相关内存，也会返回零结果。

这个叉子增加了：

  • 或扩张 --多词查询被拆分并与OR连接，因此任何匹配的词都会返回结果
  • 前缀通配符 — UMass 比赛 UMass Global, home 比赛 homelab
  • 引用短语passthrough — "exact phrase" 仍然进行精确匹配
  • 学期比赛增强 --与更多查询词匹配的内存排名更高
查询 上游 此分叉
bonsai tree plant care 0个结果 89个结果
plant care 2个结果 84个结果
book writing style 22个结果 287个结果

保留了现有的波特堵塞和混合评分（重要性/新近性/频率）。

设置

MCP服务器（分叉）

安装依赖项：

cd memory-mcp-fork
npm install --ignore-scripts

克劳德代码(~/.claude/.mcp.json)

{
  "mcpServers": {
    "memory": {
      "command": "node",
      "args": ["/path/to/claude-memory-tools/memory-mcp-fork/dist/index.js"]
    }
  }
}

克劳德桌面(claude_desktop_config.json)

{
  "mcpServers": {
    "memory": {
      "command": "node",
      "args": ["/path/to/claude-memory-tools/memory-mcp-fork/dist/index.js"]
    }
  }
}

Python工具

不依赖Python 3.10+标准库。

工具

import_to_memory.py --导入标记文件

导入文件夹 .md 文件（例如容量/黑曜石/Notion导出）作为内存：

python import_to_memory.py /path/to/markdown/folder
  • 每个文件都成为一个内存条目
  • 根据内容生成摘要
  • 填充FTS指数
  • 将源文件名存储在元数据中以进行重复数据删除

import_all_sessions.py --导入克劳德代码会话

批量导入所有Claude Code JSONL会话文件作为可搜索内存：

python import_all_sessions.py                  # convert + import all
python import_all_sessions.py --rebuild-fts    # rebuild FTS index only
python import_all_sessions.py --convert-only   # dry run, no DB changes
python import_all_sessions.py --import-only    # import pre-converted chunks
  • 将大型会话分为约4000个字符块（符合MCP的代币预算）
  • 生成人类可读的摘要
  • 按源文件名进行重复数据消除
  • 跳过代理子流程和小型会话（<5条消息）

memory_search.py --CLI搜索

从命令行搜索、列出和管理内存：

python memory_search.py bonsai              # search
python memory_search.py "plant care"        # phrase search
python memory_search.py --list              # list all
python memory_search.py --stats             # DB statistics
python memory_search.py --delete mem_abc    # soft-delete by ID prefix

export_chat.py --导出对话

将Claude Code JSONL会话转换为可读的markdown：

python export_chat.py session.jsonl                    # outputs session.md
python export_chat.py session.jsonl my_export.md       # custom output path

数据库位置

MCP将其SQLite数据库存储在：

平台 路径
窗户 %APPDATA%/claude-memories/memory.db
macOS ~/.claude-memories/memory.db
Linux ~/.local/share/claude-memories/memory.db

用覆盖 MEMORY_DB_PATH 环境变量。

许可证

内存mcp fork基于 @当月亮afk/记忆mcp （MIT许可证）。Python工具是麻省理工学院授权的。

相关 MCP