记忆监控神经脑图

一个用于可视化Claude Code持久记忆系统的交互式3D神经脑图工具,支持记忆节点探索、过滤和分析。

  • by cdeust
  • HTML
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 cdeust/memory-monitor

使用说明

内存监视器

Claude Code持久记忆系统的神经脑图可视化。

读取您的MCP服务器 ~/.claude/ 内存文件,并在浏览器中将其渲染为交互式3D神经网络——由Three.js提供支持,具有bloom、vignette、突触流粒子和力定向聚类。

它的作用

  • 3D神经图 --每个内存(用户偏好、反馈、项目上下文、引用)都是一个发光的节点。相关记忆之间的联系表现为与动态流动粒子的突触联系。
  • 交互式探索 --单击任何节点以检查其完整内容、元数据、标签和交叉引用。悬停以突出显示连接。双击以重置相机。
  • 过滤 --在整个内存图中按内存类型(用户、反馈、项目、引用)、类别、项目、线程或自由文本搜索进行筛选。
  • 分析仪表板 --活动热图、会议时间线、类别细分、顶级工具、会议持续时间分布和项目覆盖率图表。
  • 力导向布局 --相关的记忆有机地聚集在一起。在集群视图和时间线视图之间切换。
  • 自动旋转 --大脑地图在空闲时会缓慢地绕轨道运行,给监控室的监控带来美感。

安装

先决条件

  • Node.js>=18 (不需要npm包——零依赖)
  • 克劳德代码 启用存储系统(~/.claude/ 目录)

通过克劳德代码市场(推荐)

/plugin marketplace add cdeust/memory-monitor
/plugin install memory-monitor

安装后重新启动Claude Code。

手动设置

git clone https://github.com/cdeust/memory-monitor.git
cd memory-monitor
bash scripts/setup.sh

安装脚本将:

  1. 验证Node.js版本
  2. 在中注册MCP服务器 ~/.claude/mcp_config.json
  3. 将斜线命令和技能符号链接到 ~/.claude/

然后 重新启动克劳德代码 激活插件。

用法

斜杠命令

/memory-monitor

这将在默认浏览器中启动交互式脑图可视化。

MCP工具

MCP服务器公开了这些工具(可由Claude调用或通过技能调用):

工具 说明
get_memory_graph 以JSON格式返回所有内存+计算连接以进行可视化
get_memory_stats 按类型、项目和新旧程度汇总计数
search_memories 使用可选类型/项目筛选器进行全文搜索
get_memory_detail 按ID显示单个内存的全部内容
open_visualization 在浏览器中启动大脑图谱

示例

询问克劳德代码:

  • “显示我的内存图” --打开可视化
  • “我有多少记忆?” --返回统计数据
  • “在我的记忆中搜索React” --在所有内存文件中搜索
  • “我对测试的反馈记忆说了什么?” --检索特定内存内容

建筑

memory-monitor/
  .claude-plugin/plugin.json   — Plugin manifest
  .mcp.json                    — MCP server config (stdio JSON-RPC 2.0)
  mcp-server/index.js          — Zero-dependency MCP server (Node.js)
  ui/index.html                — Self-contained Three.js visualization (~5000 lines)
  commands/memory-monitor.md   — Slash command definition
  skills/memory-monitor/       — Claude Code skill with tool bindings
  scripts/setup.sh             — One-line installer

运作原理

  1. 这 MCP服务器 扫描 ~/.claude/projects/*/memory/ 目录 .md 带有YAML frontmatter的文件
  2. 它解析每个文件中的内存类型、名称、描述和正文内容
  3. 它计算 连接 基于共享标签、交叉引用和内容相似性的记忆之间
  4. 这 可视化 接收图形数据并将其渲染为Three.js场景,其中:
    • 二十面体网格用于记忆,六边形网格用于对话
    • 通过添加混合的精灵纹理发光光晕
    • 不真实的BloomPass后处理+小插图+胶片颗粒
    • 基于项目聚类的强制3D布局
    • 沿连接的边缘流动粒子(突触脉冲)
    • 大气中的环境粉尘颗粒

内存类型→ 节点颜色

类型 颜色 描述
用户 青色 #00d2ff 角色、偏好、知识
反馈 橙色 #ff6b35 更正和指导
项目 绿色 #26de81 正在进行的工作背景
参考 紫色 #a55eea 外部资源指针
对话 粉红色 #ff4081 会话线程

键盘快捷键

关键 行动
T 切换集群/时间线布局
A 切换分析仪表板
Esc 关闭详图面板
滚动 放大/缩小
拖动 动态观察相机
点击节点 选择并检查
双击 重置摄像头

许可证

麻省理工学院

作者

克莱门特·德斯特