Local Memory

License: MIT Node.js Version

一个完全本地运行的 MCP (Model Context Protocol) 记忆服务器，无需任何 API 密钥，所有数据存储在本地 JSON 文件中。

✨ 功能特性

• 🔒 完全本地 - 无需网络连接，无需 API 密钥，完全离线运行
• 💾 JSON 存储 - 数据存储在本地 JSON 文件中，易于备份和迁移
• 🔍 智能搜索 - 使用 Fuse.js 实现模糊匹配搜索
• 📊 会话管理 - 支持多会话管理，便于分类组织
• 📅 时间线查看 - 按时间查看记忆历史
• 🏷️ 标签分类 - 支持类型和标签分类
• 🤖 自动记录 - 自动记录关键提示词和代码变更
• 📝 提示词历史 - 完整记录所有提示词历史
• 🔄 代码变更追踪 - 自动记录重要的代码文件变更

🚀 快速开始

前置要求

• Node.js 18+ (下载)
• Cursor IDE 或支持 MCP 协议的 IDE

安装步骤

1. 克隆仓库

git clone https://github.com/yourusername/local-memory-mcp-server.git
cd local-memory-mcp-server

2. 安装依赖

npm install

3. 配置 Cursor

打开 Cursor 设置 (Ctrl+Shift+P → "Preferences: Open User Settings (JSON)")，添加：

{
  "mcp.servers": {
    "local-memory": {
      "command": "node",
      "args": ["/path/to/local-memory-mcp-server/server.js"]
    }
  }
}

⚠️ Windows 用户： 使用完整路径，例如："C:\\Users\\YourName\\local-memory-mcp-server\\server.js"

4. 重启 Cursor

重启 Cursor IDE 以使配置生效。

📖 使用方法

添加记忆

在 Cursor 中直接说：

记住：用户喜欢使用深色主题

或使用工具：

add_memory({
  content: "用户喜欢使用深色主题",
  type: "preference",
  importance: 8
})

搜索记忆

搜索关于 "主题" 的记忆

查看最近上下文

获取最近24小时的记忆

查看时间线

显示最近7天的记忆时间线

管理会话

列出所有会话
创建一个新会话叫 "项目A"

自动记录功能

系统会自动记录：

• 包含关键词的提示词（"记住"、"重要"、"修复"等）
• 重要的代码文件变更（超过10行或包含关键词）

查看自动记录：

获取最近24小时的提示词历史
获取代码变更历史

🛠️ 可用工具

工具	描述	参数
add_memory	添加新记忆	content(必填), type, tags, importance
search_memory	搜索记忆（模糊匹配）	query(必填), limit, type
get_recent_context	获取最近上下文	limit, hours
timeline	查看时间线	days, session_id
get_observation	获取指定记忆	id(必填)
update_memory	更新记忆	id(必填), content, importance
delete_memory	删除记忆	id(必填)
list_sessions	列出会话	limit
create_session	创建会话	name(必填)
get_session	获取会话详情	id(必填)
auto_record_prompt	自动记录提示词	prompt(必填), context
auto_record_change	自动记录代码变更	file_path, change_type, content
get_prompts_history	获取提示词历史	limit, hours
get_changes_history	获取代码变更历史	limit, file_path
stats	查看统计信息	-
help	获取帮助	-

📁 项目结构

local-memory-mcp-server/
├── server.js              # MCP 服务器主文件
├── auto-memory.js         # 自动记录模块
├── package.json           # 项目配置
├── README.md              # 项目文档
├── LICENSE                # MIT 许可证
├── hooks/                 # Git hooks（可选）
│   ├── git-post-commit.js
│   └── cursor-command.js
├── demo.js                # 功能演示脚本
├── demo-auto-record.js    # 自动记录演示
└── *.md                   # 文档文件

📁 数据存储

数据默认存储在：

• Windows: C:\Users\<用户名>\.local-memory-mcp\memory.json
• Linux/Mac: ~/.local-memory-mcp/memory.json

可通过环境变量 MEMORY_DATA_DIR 自定义存储位置。

数据文件说明

• memory.json - 主数据库文件（包含所有记忆、会话、提示词）
• prompts.log - 提示词日志文件
• changes.log - 代码变更日志文件

🔧 高级配置

自定义数据目录

在 Cursor 配置中添加环境变量：

{
  "mcp.servers": {
    "local-memory": {
      "command": "node",
      "args": ["/path/to/server.js"],
      "env": {
        "MEMORY_DATA_DIR": "/custom/path/to/data"
      }
    }
  }
}

Git 集成（可选）

安装 Git post-commit hook 自动记录提交的变更：

# Windows PowerShell
.\setup-auto-record.ps1

# Linux/Mac
cp hooks/git-post-commit.js .git/hooks/post-commit
chmod +x .git/hooks/post-commit

📊 记忆类型

建议使用的记忆类型：

• general - 一般信息（默认）
• fact - 事实信息
• preference - 用户偏好
• task - 任务相关
• note - 笔记
• code - 代码相关
• project - 项目信息
• prompt - 提示词（自动记录）
• code_change - 代码变更（自动记录）

🎯 使用场景

场景1：记住项目偏好

记住：这个项目使用 Python 3.11，框架是 FastAPI

场景2：记住常用命令

记住：部署命令是 npm run deploy:prod

场景3：回顾项目历史

搜索关于 "部署" 的所有记忆
显示最近30天的记忆时间线

场景4：自动记录工作流程

• 系统自动记录您的提示词
• 自动记录重要的代码修改
• 随时查看历史记录

🔒 隐私与安全

• ✅ 完全本地 - 所有数据存储在您的设备上
• ✅ 无需网络 - 完全离线运行
• ✅ 无需 API - 不需要任何在线服务或密钥
• ✅ 数据可控 - 您完全控制自己的数据

❓ 常见问题

Q: 服务器无法启动？

A: 确保已安装 Node.js 18+ 并运行 npm install

Q: 记忆没有保存？

A: 检查数据目录是否有写入权限

Q: 如何备份数据？

A: 直接复制 memory.json 文件即可

Q: 如何迁移数据？

A: 将 memory.json 复制到新位置，并更新配置中的 MEMORY_DATA_DIR

Q: 为什么有些提示词没有自动记录？

A: 系统只记录包含关键词或较长的提示词。可以修改 auto-memory.js 中的 isKeyPrompt() 函数调整规则。

Q: 数据会丢失吗？

A: 所有数据保存在本地 JSON 文件中。建议定期备份 memory.json 文件。

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📜 许可证

本项目采用 MIT License 许可证。

🙏 致谢

• Model Context Protocol - MCP 协议
• Fuse.js - 模糊搜索库

📞 联系方式

如有问题或建议，请提交 Issue。

---

Made with ❤️ for privacy-conscious developers