AI 长期记忆 MCP 服务器

一个为 AI 智能体提供持久化长期记忆的模型上下文协议 (MCP) 服务器。专为 Claude Code 的实际使用而设计，使 AI 系统能够跨会话进行记忆。

特性

• 分层记忆架构：3 层系统（事实 → 经验 → 决策链）

• 语义搜索：使用余弦相似度的基于嵌入的检索

• 记忆衰减：基于激活的衰减——被调用的记忆保持活跃，未使用的记忆逐渐消退

• 情感感知：存储情感效价和强度，实现“闪光灯记忆”效应

• 自动呈现：由对话上下文触发的基于钩子（Hook）的自动记忆检索

• 去重：自动合并相似记忆（相似度阈值 > 80%）

Related MCP server: Recall

架构

┌─────────────────────────────────────────┐
│              Claude Code                │
│         (or any MCP client)             │
├─────────────────────────────────────────┤
│            MCP Protocol                 │
├─────────────────────────────────────────┤
│          Memory MCP Server              │
│  ┌───────────┐  ┌──────────────────┐   │
│  │  Write /   │  │  Surface /       │   │
│  │  Update /  │  │  Search /        │   │
│  │  Delete    │  │  Read            │   │
│  └─────┬─────┘  └────────┬─────────┘   │
│        │                 │              │
│  ┌─────▼─────────────────▼─────────┐   │
│  │         SQLite Database          │   │
│  │  memories + embeddings + decay   │   │
│  └─────────────────────────────────┘   │
├─────────────────────────────────────────┤
│         Auto-Surface Hook              │
│  (keyword matching on user input)      │
└─────────────────────────────────────────┘

记忆模式

MCP 工具

衰减机制

记忆根据 last_activated（最后激活时间）而非 created_at（创建时间）进行衰减。不断被调用的记忆将无限期保持活跃。衰减阈值：

• 低重要性 (1-2) + 7 天内未激活 → 衰减

• 中重要性 (3) + 14 天内未激活 → 衰减

• 高重要性 (4-5) + 30 天内未激活 → 衰减

• 固定（Pinned）记忆永不衰减

灵感来源于人类记忆巩固研究——参考了 8 篇论文（见 design doc）。

自动呈现钩子

auto_surface.cjs 作为 Claude Code 的 UserPromptSubmit 钩子运行。在每条用户消息上，它会：

1. 从消息中提取关键词

2. 在记忆数据库中搜索匹配项

3. 将相关记忆注入对话上下文

这实现了无需显式搜索命令的被动召回。

设置

npm install

添加到 Claude Code MCP 配置：

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

设计决策

• SQLite 优于向量数据库：部署更简单，单文件，对于 <10K 条记忆足够使用

• 基于激活的衰减优于基于时间的衰减：模拟人类记忆——被使用的记忆会增强，未使用的会消退

• 嵌入去重：防止因重复相似事件导致的记忆膨胀

• 分层架构：将事实（稳定）、经验（上下文相关）和决策（可操作）分离开来

研究参考

基于 8 篇论文的研究构建：

• Generative Agents (Stanford, 2023): 记忆流、反思、规划/反应

• MemGPT (2023): 具有操作系统启发式页面管理的分层记忆

• LUFY (2024): 具有情感唤醒加权的遗忘机制

• MemoRAG (2024): 具有双重评分的记忆启发式检索

• Mem0 (2024): 具有自动提取和去重的基于图的记忆

• A-Mem (2024): 自组织智能体记忆网络

• LoCoMo (2024): 长上下文对话记忆基准

• Chloe/Noah (社区): 四维伴侣 AI 记忆

详见 docs/design.md 中对每篇论文影响的详细分析。

状态

处于活跃日常使用中。在 17 个会话中积累了 95 条以上的记忆。正根据实际使用模式进行迭代。

许可证

MIT