🧠 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更好地思考和记忆！

ThinkMem