星战科技xingzhan.cloud
返回市场
内存仪表盘

内存仪表盘

作者：doobidoo18 星标更新：2025-10-11
安装使用来源：spider==github.com

项目介绍

技术文档摘要

🚨 已弃用 - 此仓库不再需要！ 🚨

⚠️ 重要通知：此独立仪表板现已过时！

MCP 内存服务现在包含一个嵌入式仪表板，具有此独立版本的所有功能以及更多新功能！

🎉 新功能是什么？

主要的 MCP 内存服务现在提供：

  • ✅ 内置 Web 仪表板 - 不需要单独安装
  • ✅ 所有原始功能 - 存储、搜索、回忆和管理记忆
  • ✅ 更好的集成 - 直接访问内存服务
  • ✅ 简化设置 - 一次安装，全部包括
  • ✅ 持续开发 - 定期添加新功能

🔄 如何迁移

  1. 更新您的 MCP 内存服务：

    git pull origin main
python install.py

  2. 访问嵌入式仪表板：

    • 使用 HTTP 模式启动内存服务
    • 在浏览器中导航到 http://localhost:8000
    • 享受无需此独立应用的所有功能！

📦 为什么会被弃用？

为了提供更好的用户体验，我们已将仪表板直接集成到内存服务中。这意味着：

  • 更少的依赖项需要管理
  • 更简单的安装和更新
  • 更好的性能和可靠性
  • 所有功能的单一数据源

🔗 开始使用

访问主仓库以获取安装和使用说明：

👉 MCP 内存服务

原始 README 内容保留如下供历史参考。

MCP 内存仪表板 <img width="60" alt="grafik" src="https://gips0.baidu.com/it/u=3424580870,2305207473&fm=3081&app=3081&f=PNG?w=480&h=576" />

一个专业的桌面应用程序，用于管理和与 MCP 内存服务 进行交互 - 基于模型上下文协议（MCP）构建的语义记忆系统。

🚀 新功能：高性能 Docker ChromaDB 集成

重大更新：现在支持直接 Docker ChromaDB 访问，性能提升 2-3倍 并且 零服务冲突！

⚡ Docker 模式优势

  • 🚀 2-3倍更快：直接 HTTP 访问消除了 MCP 的开销（50-150毫秒 vs 200-500毫秒）
  • 🔄 零冲突：消除了可能导致干扰 Claude Desktop 的 MCP 服务重复
  • 💾 零数据丢失：通过卷挂载直接使用现有数据库
  • 🐳 自动管理：透明的 Docker 容器生命周期管理
  • 🛡️ 平滑回退：如果 Docker 不可用，自动回退到传统的 MCP

快速 Docker 设置

  1. 安装 Docker Desktop（如果尚未安装）
  2. 启用 Docker 模式：在 .env 文件中设置 VITE_USE_DIRECT_CHROMA_ACCESS=true
  3. 启动仪表板：npm start - Docker 容器自动管理！

📖 完整的 Docker 设置指南 | 🏗️ 技术架构细节

✨ 功能

🧠 记忆管理

  • 存储记忆：保存带有标签和元数据的内容
  • 语义搜索：使用自然语言查询查找记忆，并附带单个删除按钮
  • 基于时间的回忆：按时间表达式搜索记忆（“昨天”，“上周”等）
  • 单个记忆删除：删除特定记忆并附带确认对话框
  • 标签管理：通过标签组织和删除记忆，支持多选
  • 实时结果：即时搜索和检索，附带相似度评分

📊 仪表板及分析

  • 实时统计：总记忆数、唯一标签数、数据库健康状况
  • 数据库健康监控：实时健康状态（0-100%）
  • 性能指标：实际平均查询时间跟踪（1-3秒）
  • 存储信息：数据库大小和路径信息
  • 四标签界面：专用的存储、搜索、回忆和标签管理标签页

🔧 数据库操作

  • 数据库优化：清理和优化向量索引
  • 备份创建：创建带有详细反馈的时间戳备份（文件路径、大小、时间戳）
  • 健康检查：验证数据库完整性及性能
  • 自动初始化：无缝的 ChromaDB 设置和配置
  • 完整备份系统：完全压缩的 tar.gz 文件，附带成功通知

🏷️ 增强的标签管理

  • 多标签删除：选择并同时删除多个标签
  • 视觉标签选择：具有添加/移除功能的互动标签芯片
  • 灵活的删除选项：支持单个和多个标签删除
  • API 一致性：与搜索功能一致的接口
  • 清晰警告：理解标签操作中的 OR 和 AND 逻辑

⏰ 基于时间的回忆系统

  • 快速筛选：一键按钮 [今天] [昨天] [上周] [上月] [过去三个月]
  • 自然语言：自由文本时间表达如“两天前”，“去年夏天”
  • 智能处理：适当情况下结合时间过滤和语义搜索
  • 专用标签页：分离的“按时间回忆”界面用于时间查询

🎨 用户体验

  • 加载指示器：数据库初始化期间的视觉反馈
  • 进度追踪：启动过程中的逐步状态更新
  • 专业界面：干净、现代的基于 Electron 的桌面应用
  • 键盘快捷键：F12 或 Ctrl+Shift+I 打开开发者工具
  • 响应式设计：适应不同窗口大小的布局
  • 丰富的反馈：详细的成功/错误消息，可关闭的通知
  • 安全特性：破坏性操作的确认对话框

🚀 快速开始

先决条件

  • Node.js（v16或更高版本）
  • Python（v3.10或更高版本），带有 UV 包管理器
  • MCP 内存服务（兼容安装）

安装

  1. 克隆仓库：

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

  2. 安装依赖项：

    npm install

  3. 配置环境变量： 在项目根目录下创建一个 .env 文件：

    macOS/Linux:

    # 基本配置
VITE_MEMORY_SERVICE_PATH="/path/to/mcp-memory-service"
VITE_MEMORY_CHROMA_PATH="/Users/yourusername/Library/Application Support/mcp-memory/chroma_db"
VITE_MEMORY_BACKUPS_PATH="/Users/yourusername/Library/Application Support/mcp-memory/backups"
VITE_CLAUDE_CONFIG_PATH="/Users/yourusername/Library/Application Support/Claude/claude_desktop_config.json"

# 🚀 新功能：Docker ChromaDB 模式（高性能）
VITE_USE_DIRECT_CHROMA_ACCESS=true   # 启用 Docker 模式以获得 2-3倍的性能
# VITE_USE_DIRECT_CHROMA_ACCESS=false  # 传统 MCP 模式（稳定的回退）

    Windows:

    # 基本配置
VITE_MEMORY_SERVICE_PATH="C:\path\to\mcp-memory-service"
VITE_MEMORY_CHROMA_PATH="C:\Users\%USERNAME%\AppData\Local\mcp-memory\chroma_db"
VITE_MEMORY_BACKUPS_PATH="C:\Users\%USERNAME%\AppData\Local\mcp-memory\backups"
VITE_CLAUDE_CONFIG_PATH="C:\Users\%USERNAME%\AppData\Roaming\Claude\claude_desktop_config.json"

# 🚀 新功能：Docker ChromaDB 模式（高性能）
VITE_USE_DIRECT_CHROMA_ACCESS=true   # 启用 Docker 模式以获得 2-3倍的性能
# VITE_USE_DIRECT_CHROMA_ACCESS=false  # 传统 MCP 模式（稳定的回退）

  4. 启动应用：

    npm start

🪟 Windows 特定注意事项

路径配置

  • 使用 双反斜杠 (\\) 或 正斜杠 (/) 在路径中
  • 环境变量 %USERNAME% 会自动解析为你的 Windows 用户名
  • Claude Desktop 配置存储在 AppData\Roaming\Claude\
  • 内存数据存储在 AppData\Local\mcp-memory\

PowerShell 执行策略

如果你遇到脚本执行错误，可能需要启用脚本执行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

常见 Windows 路径

  • Claude 配置：C:\Users\<username>\AppData\Roaming\Claude\claude_desktop_config.json
  • 内存数据库：C:\Users\<username>\AppData\Local\mcp-memory\chroma_db
  • 备份：C:\Users\<username>\AppData\Local\mcp-memory\backups

⚙️ 配置

MCP 内存服务设置

确保你的 MCP 内存服务在 Claude Desktop 配置中正确设置：

macOS/Linux:

{
  "mcpServers": {
    "memory": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-memory-service", "run", "memory"],
      "env": {
        "MCP_MEMORY_CHROMA_PATH": "/Users/yourusername/Library/Application Support/mcp-memory/chroma_db",
        "MCP_MEMORY_BACKUPS_PATH": "/Users/yourusername/Library/Application Support/mcp-memory/backups"
      }
    }
  }
}

Windows:

{
  "mcpServers": {
    "memory": {
      "command": "uv",
      "args": ["--directory", "C:\\path\\to\\mcp-memory-service", "run", "memory"],
      "env": {
        "MCP_MEMORY_CHROMA_PATH": "C:\\Users\\yourusername\\AppData\\Local\\mcp-memory\\chroma_db",
        "MCP_MEMORY_BACKUPS_PATH": "C:\\Users\\yourusername\\AppData\\Local\\mcp-memory\\backups"
      }
    }
  }
}

环境变量

变量描述macOS/Linux 示例Windows 示例
VITE_MEMORY_SERVICE_PATHMCP 内存服务路径/path/to/mcp-memory-serviceC:\path\to\mcp-memory-service
VITE_MEMORY_CHROMA_PATHChromaDB 数据库目录~/Library/Application Support/mcp-memory/chroma_dbC:\Users\%USERNAME%\AppData\Local\mcp-memory\chroma_db
VITE_MEMORY_BACKUPS_PATH备份存储目录~/Library/Application Support/mcp-memory/backupsC:\Users\%USERNAME%\AppData\Local\mcp-memory\backups
VITE_CLAUDE_CONFIG_PATHClaude Desktop 配置文件~/Library/Application Support/Claude/claude_desktop_config.jsonC:\Users\%USERNAME%\AppData\Roaming\Claude\claude_desktop_config.json
VITE_USE_DIRECT_CHROMA_ACCESS🚀 新功能：启用 Docker ChromaDB 模式true (Docker) / false (MCP)true (Docker) / false (MCP)

🐳 Docker vs MCP 模式比较

功能Docker 模式 (true)MCP 模式 (false)
性能2-3倍更快 (50-150毫秒)标准 (200-500毫秒)
服务冲突无 (消除重复)可能 (MCP 冲突)
要求需要 Docker Desktop需要 Python + UV
数据迁移无 (使用现有数据库)无 (使用现有数据库)
可靠性自动重启，健康监控取决于 MCP 服务
回退自动回退到 MCP不适用 (是回退模式)

🎯 使用

存储记忆

  1. 导航到 存储记忆 标签页
  2. 在文本区域输入内容
  3. 添加逗号分隔的标签（可选）
  4. 点击 存储 以保存

搜索记忆

  1. 导航到 搜索记忆 标签页
  2. 输入搜索查询
  3. 点击 搜索 查找相关记忆
  4. 结果显示内容、标签、相似度评分和单个删除按钮 (🗑️)
  5. 点击任何记忆上的删除按钮进行个别删除并附带确认

基于时间的回忆

  1. 导航到 按时间回忆 标签页
  2. 快速筛选：点击预定义按钮 ([今天] [昨天] [上周] [上月] [过去三个月])
  3. 自由文本：输入自定义时间表达如“两天前”，“去年夏天”，“今天早上”
  4. 点击 回忆 查找该时间段的记忆
  5. 结果包括单个删除按钮和适用的相似度评分

管理标签

  1. 导航到 标签管理 标签页
  2. 在输入字段逐个输入标签并按 Enter 或点击“添加标签”
  3. 选定的标签作为带有移除 (×) 按钮的视觉芯片出现
  4. 点击每个芯片上的 × 移除不需要的标签
  5. 点击 删除 [N] 个标签 移除所有包含所选标签的记忆
  6. 使用 清除选择 移除所有选定标签而不删除
  7. ⚠️ 警告：使用 OR 逻辑 - 包含任一选定标签的记忆将被删除

数据库操作

  • 刷新统计：点击设置图标重新加载统计数据并查看实际查询时间
  • 优化数据库：点击刷新图标优化性能
  • 创建备份：点击保存图标创建带有详细反馈的时间戳备份
    • 成功消息显示：文件路径、大小（MB）、时间戳和可关闭的通知
    • 示例：“✅ 备份创建成功！ 📁 位置：/path/to/backup_20250607_143025.tar.gz 📊 大小：2.4 MB”

🏗️ 技术架构

前端

  • 框架：React 18 与 TypeScript
  • 桌面：Electron 用于跨平台桌面应用
  • 样式：Tailwind CSS 与自定义组件
  • 图标：Lucide React 图标库
  • 构建：Vite 用于快速开发和构建

后端集成

  • 协议：基于 stdin/stdout 的模型上下文协议（MCP）
  • 通信：JSON-RPC 2.0 工具调用
  • 内存服务：基于 Python 的 MCP 服务器与 ChromaDB
  • 向量数据库：ChromaDB 提供语义搜索能力

关键组件

  • 内存服务客户端：处理 MCP 通信
  • 仪表板界面：基于 React 的 UI 组件
  • Electron 主进程：桌面应用管理
  • 预加载脚本：安全地暴露 API 到渲染器

🛠️ 开发

开发模式

npm run dev

启动 Vite 开发服务器和 Electron 的开发模式，支持热重载。

构建生产版

npm run build

在 dist/ 目录中创建优化的生产构建。

可用脚本

  • npm start - 构建并运行生产版本
  • npm run dev - 启动开发服务器
  • npm run build - 构建生产版本
  • npm run electron:preview - 使用构建文件运行 Electron

🐛 故障排除

常见问题

🐳 Docker 模式问题 (VITE_USE_DIRECT_CHROMA_ACCESS=true)

“Docker 不可用”消息

“使用回退端口 8001”消息

  • 端口 8000 被其他服务占用
  • 系统自动使用备用端口（8001、8002 等）
  • 这是正常行为，不影响功能

Docker 模式初始启动较慢

  • 第一次运行下载 ChromaDB Docker 镜像（一次性，约 100MB）
  • 后续启动比 MCP 模式快
  • 控制台日志显示进度

容器健康问题