内容
# 个人记忆 MCP 服务器
> 一个轻量级、无缝和简洁的个人 AI 记忆引擎 — 您的专属智能助手，记住您在每一次对话中的信息。
## 这是什么
个人记忆是一个 [MCP](https://modelcontextprotocol.io/) （模型上下文协议）服务器，为 Claude、Cursor 和其他 AI 主机提供**持久的个人记忆**。
安装后，您的 AI 将记住您的习惯、偏好、经历和人际关系 — 不再需要每次对话都从头开始。
## 功能
| 工具 | 描述 |
|------|-------------|
| `add_memory` | 记录事件、决定、见解（自动去重） |
| `search_memories` | 全文搜索所有记忆（FTS5） |
| `get_memory_summary` | 获取完整的个人资料概览 |
| `get_daily_briefing` | 每日简报：昨天的记忆 + 跟进事项 + 习惯提醒 |
| `get_follow_ups` | 待办计划、未执行的决定、丢失的联系人 |
| `check_habit_patterns` | 检测习惯异常（例如，3 天没有锻炼） |
| `upsert_person` | 记录 / 更新一个人及其关系 |
| `feed_habit` | 记录用户习惯 |
| `feed_preference` | 记录用户偏好 |
| `import_wechat` | 导入微信聊天记录，自动提取事件 |
| `import_browser_history` | 读取 Chrome/Edge 历史记录，提取兴趣 |
| `archive_old_memories` | 存档旧的低重要性记忆 |
## 快速开始
### 选项 1: 一键安装（推荐）
**Windows（PowerShell）：**
```powershell
irm https://raw.githubusercontent.com/Emama-bit/personal-memory-mcp/master/install.ps1 | iex
```
**macOS / Linux：**
```bash
curl -fsSL https://raw.githubusercontent.com/Emama-bit/personal-memory-mcp/master/install.sh | bash
```
### 选项 2: 手动安装
**Windows（PowerShell）：**
```powershell
irm https://raw.githubusercontent.com/Emama-bit/personal-memory-mcp/master/install.ps1 | iex
```
**macOS / Linux：**
```bash
curl -fsSL https://raw.githubusercontent.com/Emama-bit/personal-memory-mcp/master/install.sh | bash
```
安装后重启 Claude Desktop / Cursor。
### 选项 2: 手动安装
```bash
git clone https://github.com/Emama-bit/personal-memory-mcp.git
cd personal-memory-mcp/agent
npm install
```
然后配置您的 AI 主机：
**Claude Desktop** — 设置 → 开发者 → 编辑配置：
```json
{
"mcpServers": {
"personal-memory": {
"command": "npx",
"args": ["tsx", "/path/to/personal-memory-mcp/agent/src/server.ts"]
}
}
}
```
**Cursor** — 创建 `.cursor/mcp.json`：
```json
{
"mcpServers": {
"personal-memory": {
"command": "npx",
"args": ["tsx", "/path/to/personal-memory-mcp/agent/src/server.ts"]
}
}
}
```
配置完成后重启您的 AI 主机。
## 使用示例
```
您：我的名字是 Alex，我每天 7 点醒来，喜欢 VS Code
AI： [静静地调用 feed_habit + feed_preference]
您：你还记得我吗？
AI： 当然！你是 Alex，7 点起床，在 VS Code 中编码...
您：搜索我关于 Rust 的记忆
AI： 你决定使用 Rust 进行新项目，因为...
```
## 架构
```
Claude / Cursor / 任意 MCP 主机
│ MCP 协议（stdio）
▼
个人记忆服务器
├── 记忆引擎（SQLite + FTS5）
├── 人际关系跟踪
├── 个人资料（习惯，偏好）
├── 主动智能（每日简报，跟进事项）
└── 数据导入（微信，浏览器历史记录）
```
- **存储**: SQLite with WAL 模式，原子写入
- **搜索**: FTS5 全文索引，支持中文和英文
- **去重**: 自动检测相似记忆后写入
- **分层**: 7 天 / 30 天 / 存档层，系统提示保持紧凑
- **隐私**: 所有数据存储本地，从不上传
## 项目结构
```
agent/
├── src/
│ ├── server.ts ← MCP 服务器入口（18 个工具）
│ ├── memory/
│ │ ├── db.ts ← SQLite 初始化 + FTS5
│ │ ├── memories.ts ← 记忆 CRUD + 搜索 + 去重
│ │ ├── people.ts ← 人际关系管理
│ │ └── conversations.ts ← 对话持久化
│ ├── profile.ts ← 用户资料（习惯，偏好）
│ ├── system.ts ← 分层系统提示生成
│ ├── wechat.ts ← 微信聊天记录解析器
│ └── browser.ts ← Chrome/Edge 历史记录读取器
├── memory/agent.db ← 本地 SQLite 数据库（gitignored）
└── package.json
```
## 联系方式
如果您有任何问题或建议，请联系我：lk2012943494@outlook.com
## 许可证
MIT
