Adaptive Memory Graph

自适应记忆图谱

一个 MCP 服务插件，为 Claude 提供跨会话持久且智能的记忆。它将知识存储为图谱中相互连接的加权节点，并在对话过程中不断演进——得到使用的节点权重会增加，未使用的节点权重会降低，最终归档。

适用于 Claude Code 和 Claude Desktop。

功能

• 加权记忆节点 — 重要记忆会保持突出；过时的记忆会逐渐淡出
• 跨领域关联 — 关联不同主题中的相关知识
• 基于时间的衰减 — 图谱会自动清理，只保留相关记忆
• 加密存储 — 使用 AES-256-GCM 加密，并通过 macOS Keychain 存储密钥
• 会话日志 — 追踪访问了哪些记忆，以及这些记忆的接收情况
• 领域组织 — 按领域组织节点（例如 health_and_safety、personal、ideas_and_projects）
• 聊天历史导入 — 查看并从过去的 Claude Code 会话中提取知识

安装

pip install adaptive-memory-graph

或者使用 uv：

uv pip install adaptive-memory-graph

设置

Claude Code

claude mcp add adaptive-memory-graph -s user -- amg-server

Claude Desktop

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "adaptive-memory-graph": {
      "command": "amg-server"
    }
  }
}

配置文件位置：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

工具

工具	描述
amg_load_index	在会话开始时加载轻量级图谱索引
amg_expand_branch	在上下文相关时获取完整节点内容
amg_get_connected_nodes	查找不同领域中的相关节点
amg_log_session	在对话结束时记录会话摘要
amg_update_graph	处理待处理日志并应用权重衰减
amg_export_report	生成易于阅读的图谱摘要
amg_manual_adjust	提高权重、降低权重、归档或删除节点
amg_add_node	向图谱添加新节点
amg_search_nodes	按标题、摘要、标签或内容搜索节点
amg_list_chat_sessions	列出可供查看的 Claude Code 聊天会话
amg_read_chat_session	读取聊天会话的对话内容

工作原理

1. 会话开始 — Claude 调用 amg_load_index，获取记忆图谱的轻量级摘要
2. 对话期间 — 如果某个主题相关，Claude 会展开特定节点以获取更深入的上下文
3. 会话结束 — Claude 会静默记录访问过的节点，并建议添加新节点
4. 会话间隔期间 — 权重衰减机制会运行，将未发挥作用的记忆归档

节点以加密 JSON 格式存储在磁盘上（~/.amg/graph.json.enc）。加密密钥存储在你的 macOS Keychain 中。

要求

• Python 3.10+
• macOS（用于基于 Keychain 的加密密钥存储）

许可证

MIT