🧠 THINK-MEM
AI Memory Management System for LLMs - 让LLM善用思考，善用记忆
📋 项目简介
ThinkMem是一个为大型语言模型设计的记忆管理MCP服务器，提供多种存储类型和通信协议，帮助LLM更好地组织和利用信息。
✨ 核心特性
- 🧠 多种内存类型: RawMemory（无结构文本）、ListMemory（数组/队列/栈）
- 🔍 智能检索: 文本搜索和行级操作
- 📝 摘要管理: 自动摘要生成和管理
- 🔄 双重模式: MCP stdio模式 + StreamableHTTP模式
- 💾 持久化存储: JSON文件存储，支持备份恢复
- 🧪 完整测试: 单元测试 + 集成测试
基本使用
只推荐两种用法：
- 单机模式(stdio)，但是为每一个AI助手显式指定存储位置(db参数)
- 多机模式(HTTP，支持StreamableHTTP)，集中管理多个AI助手的记忆，使用默认存储位置
首先安装
npm install -g thinkmem用法1：单机模式+显式指定存储位置
命令行用法（仅供调试）：
npx -g thinkmem --db path/to/db.json # 强烈建议指定db，否则不同进程可能冲突JSON：
{
"mcpServers": {
"ThinkMem": {
"command": "npx",
"args": ["-g", "thinkmem", "--db", "path/to/db.json"]
}
}
}用法2：多机模式
你应该有一个位置能够一定范围内公开部署本项目，最好是公网服务器。当然身为技术人员的你一定知道我在说什么所以我就不多说了。配置SSL等可以通过反向代理。
一、启动服务器：
npm -g install thinkmem
npx -g thinkmem --mode http --port 13809 # --db 可有可无二、给MCP Host添加AI助手：
JSON：
{
"mcpServers": {
"ThinkMem": {
"type": "streamable-http",
"url": "http://your.server:13809/mcp"
}
}
}Claude Code：
claude mcp add --transport http ThinkMem --scope user http://your.server:13809/mcp📖 详细文档
- 🏗️ 顶层设计文档 - 系统架构和设计理念
- 🤖 Claude助手指南 - Claude Code集成说明
⚙️ 配置选项
命令行参数
| 参数 | 简写 | 完整参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|---|---|
| 模式 | -m | --mode | string | stdio | 运行模式：stdio或http |
| 端口 | -p | --port | number | 13809 | HTTP服务器端口 |
| 数据库 | -d | --db | string | ~/.thinkmem/current.db | 数据库文件路径 |
🏃♂️ 运行模式
下面开始是你clone了repo之后才能做的事，不是npx的用法
📡 Stdio模式
适用于: AI助手集成、本地开发、MCP生态系统
# 默认stdio模式
npm start🌐 HTTP模式（StreamableHTTP）
适用于: Web应用、移动应用、多客户端、实时功能
# 基础HTTP模式
npm start -- --mode http
# 自定义端口
npm start -- --mode http --port 3000📊 模式对比
| 功能 | Stdio模式 | HTTP模式 |
|---|---|---|
| 协议 | stdin/stdout | StreamableHTTP |
| 客户端 | 单个 | 多个并发 |
| 复杂度 | 简单 | 需要端口配置 |
| 使用场景 | 测试环境使用 | 生产环境使用 |
🧠 内存类型和操作
RawMemory（无结构内存）
- 用途: 存储文本文档、笔记、日志
- 功能: 行级文本操作、摘要管理、智能搜索
- 特性: 自动摘要优化、行号索引、内容搜索
主要操作:
- 文本写入、追加、插入、删除、替换
- 摘要管理和智能读取
- 基于模式的内容搜索
ListMemory（列表内存）
- 用途: 任务列表、工作流、临时数据
- 功能: 有序集合管理，支持三种角色模式和名称唯一性
🆕 名称唯一性机制
- 每个元素都有唯一的标识符名称
- 支持按名称快速查找和删除元素
- 自动维护名称映射表，提供O(1)查找性能
- 防止重复名称，确保数据完整性
- 支持嵌套元素的高效管理
支持的角色类型
- Array（数组）: 基础列表操作
- 添加、插入、删除元素 - 按索引访问和修改 - 支持按名称查找和删除
- Deque（双端队列）: 先进先出/后进先出
- 两端添加和移除元素 - 队列和栈操作 - 支持按名称管理元素
- Stack（栈）: 后进先出
- 压栈、弹栈、栈顶查看 - LIFO数据管理 - 支持按名称管理元素
🧪 开发和测试
开发命令
# 安装依赖
npm install
# 开发模式（stdio）
npm run dev
# 编译TypeScript
npm run build
# 运行生产版本
npm start
# 代码检查
npm run lint
# 运行测试
npm test
# 运行特定测试
npm test -- --testNamePattern="RawMemory"📄 许可证
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。
🙏 致谢
- Model Context Protocol - 提供AI助手通信协议
- TypeScript - 类型安全的JavaScript
📞 支持
如果您遇到问题或有建议，请：
- 查看设计文档了解系统架构
- 查看Claude集成指南了解AI助手使用
- 搜索Issues查看已知问题
- 创建新的Issue报告问题
🚀 让LLM更好地思考和记忆！