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

⚠️ 重要通知：此独立仪表板现已过时！ 该 MCP内存服务现在包括一个 嵌入式仪表盘 具备此独立版本的所有功能，甚至更多！ ## 🎉 有什么新变化？当前，主要的MCP内存服务提供： - ✅ 内置网页仪表板 - 无需单独安装 - ✅ 所有原创特性 - 存储、搜索、回忆和管理记忆 - ✅ 更好的整合 - 直接访问内存服务 - ✅ 简化设置 - 一次安装，应有尽有 - ✅ 积极开发 - 定期添加新功能 ## 🔄 如何迁移 1. 更新您的MCP内存服务： ``bash git pull origin main python install.py ` 1. **访问嵌入式仪表板**： - 以HTTP模式启动内存服务 - 导航至 http://localhost:8000` 在您的浏览器中 - 无需单独应用，即可享受所有功能！ ## 📦 为什么这个已被弃用？为了提供更好的用户体验，我们已将仪表板直接集成到内存服务中。这意味着： - 更少的依赖项需要管理 - 更简便的安装和更新 - 更佳的性能和可靠性 - 所有功能的唯一真实数据源 ## 🔗 开始使用访问主仓库以获取安装和使用说明： 👉 MCP内存服务 ______________________________________________________________________ *以下保留了原始的README内容，以供历史参考。* ______________________________________________________________________

MCP内存仪表盘

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

🚀 表示火箭或快速上升、前进的意思，可以翻译为“🚀（火箭/快速上升/前进）”。不过，具体翻译可能需要根据上下文来确定最准确的表达。新增：高性能 Docker 与 ChromaDB 集成

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

⚡（闪电符号，常用于表示速度、能量或快速变化） Docker模式的优势

🚀 2-3倍更快直接HTTP访问消除了MCP（管理控制协议）的开销（从50-150毫秒缩短至200-500毫秒）
🔄 无冲突消除可能干扰Claude Desktop的MCP服务重复
💾 零数据丢失通过卷挂载直接使用您现有的数据库
🐳 自动管理透明的Docker容器生命周期管理
🛡️ 优雅降级如果Docker不可用，则自动回退到传统的MCP

快速Docker设置

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

📖 ** 🏗️ 技术架构细节**

✨ 特点/功能

🧠 表示“大脑”或“思考”的意思。内存管理

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

📊（表格）仪表盘与分析

实时统计数据总内存、唯一标签、数据库健康状况
数据库健康监测实时健康状态（0-100%）
性能指标实际平均查询时间追踪（1-3秒）
存储信息数据库大小和路径信息
4-Tab界面专为商店、搜索、回忆和标签管理设计的选项卡

🔧（扳手，常用于表示修理或维护）数据库操作

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

标签增强的标签管理

多标签删除同时选择和删除多个标签
视觉标签选择具有添加/删除功能的交互式标签芯片
灵活的删除选项支持单个和多个标签的删除
API 一致性具有搜索功能的一致性界面
明确警告理解标签操作中的“或”（OR）与“与”（AND）逻辑

⏰（时钟符号，通常表示时间或提醒）基于时间的召回系统

快速过滤器一键按钮：\[今天\] \[昨天\] \[上周\] \[上个月\] \[过去3个月\]
自然语言像“2天前”、“去年夏天”这样的自由文本时间表达
智能处理在适当的时候，将时间过滤与语义搜索相结合
专用标签页为时间查询提供单独的“按时间召回”界面

🎨 画笔/绘画（表情符号，无直接对应文字，可理解为表示绘画或艺术创作）用户体验

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

🚀 快速入门

先决条件

Node.js （v16或更高版本）
python (v3.10 或更高版本) 配备 UV 包管理器
MCP内存服务 （兼容安装）

安装

克隆仓库:

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

安装依赖项：

   npm install

配置环境变量：

创建一个 .env 项目根目录中的文件：

macOS/Linux：

   # Basic Configuration
   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"

   # 🚀 NEW: Docker ChromaDB Mode (High Performance)
   VITE_USE_DIRECT_CHROMA_ACCESS=true   # Enable Docker mode for 2-3x faster performance
   # VITE_USE_DIRECT_CHROMA_ACCESS=false  # Traditional MCP mode (stable fallback)

Windows：

   # Basic Configuration
   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"

   # 🚀 NEW: Docker ChromaDB Mode (High Performance)
   VITE_USE_DIRECT_CHROMA_ACCESS=true   # Enable Docker mode for 2-3x faster performance
   # VITE_USE_DIRECT_CHROMA_ACCESS=false  # Traditional MCP mode (stable fallback)

启动应用程序:

   npm start

🪟 Windows 特定注意事项

路径配置

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

PowerShell 执行策略

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

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

常见的Windows路径

克劳德配置: C:\Users\\AppData\Roaming\Claude\claude_desktop_config.json
内存数据库： C:\Users\\AppData\Local\mcp-memory\chroma_db
备份: C:\Users\\AppData\Local\mcp-memory\backups

⚙️ 配置

MCP内存服务设置

确保您的MCP内存服务在Claude桌面配置中已正确设置：

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_PATH`	MCP 内存服务的路径	`/path/to/mcp-memory-service`	`C:\path\to\mcp-memory-service`
`VITE_MEMORY_CHROMA_PATH`	ChromaDB 数据库目录	`~/Library/Application Support/mcp-memory/chroma_db`	`C:\Users\%USERNAME%\AppData\Local\mcp-memory\chroma_db`
`VITE_MEMORY_BACKUPS_PATH`	备份存储目录	`~/Library/Application Support/mcp-memory/backups`	`C:\Users\%USERNAME%\AppData\Local\mcp-memory\backups`
`VITE_CLAUDE_CONFIG_PATH`	Claude Desktop 配置文件	`~/Library/Application Support/Claude/claude_desktop_config.json`	`C:\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 与 MCP 模式对比

功能	Docker 模式 (`true`)	MCP 模式 (`false`）
演出	2-3倍更快 (50-150毫秒)	标准(200-500毫秒)
服务冲突	无 (消除重复)	可能(MCP冲突)
要求	需要 Docker Desktop	需要 Python + UV
数据迁移	无 (使用现有数据库)	无（使用现有数据库）
可靠性	自动重启，健康监测	依赖于MCP服务
备用方案；回退；降级	自动回退到MCP	不适用（即回退选项）

🎯 使用方法

存储记忆

导航至 存储内存 制表符（或按Tab键）
在文本区域中输入您的内容
添加逗号分隔的标签（可选）
点击商店保存

搜寻记忆

导航至 搜索记忆 制表符
输入您的搜索查询
点击搜索寻找相关的记忆
结果显示内容、标签、相似度评分以及单独的删除按钮（🗑️）
点击任意内存上的删除按钮，进行确认后单独删除

基于时间的回忆（或时间触发的回忆）

导航至 按时间召回 制表符
快速过滤器点击预定义的按钮（\[今天\] \[昨天\] \[上周\] \[上个月\] \[过去3个月\]）
自由文本输入自定义时间表达式，如“2天前”、“去年夏天”、“今天早上”
点击召回寻找那个时期的回忆
结果包括单独的删除按钮以及在适用情况下的相似度评分

管理标签

导航至 标签管理 制表符（Tab键）
在输入框中逐个输入标签，然后按回车键或点击“添加标签”
选定的标签以可视化的标签芯片形式显示，并带有移除（×）按钮
点击每个标签上的×来移除不需要的标签
点击 删除\[N\]个标签 删除所有包含所选标签的记忆
使用 清除选择 移除所有选中的标签，而不进行删除
⚠️（警告）警告使用或（OR）逻辑 - 具有任意选定标签的内存将被删除

数据库操作

刷新统计信息点击设置图标以重新加载统计数据并查看实际查询时间
优化数据库点击刷新图标以优化性能
创建备份点击保存图标以创建带有详细反馈的时间戳备份

- 成功消息显示：文件路径、大小（以MB为单位）、时间戳，以及可关闭的通知 - 示例：“✅ 备份创建成功！📁 位置：/path/to/backup_20250607_143025.tar.gz 📊 大小：2.4 MB”

🏗️ 技术架构

前端

框架使用TypeScript的React 18
桌面用于跨平台桌面应用程序的Electron
造型使用自定义组件的Tailwind CSS
图标Lucide React 图标库
构建Vite，用于快速开发和构建

后端集成

协议模型上下文协议（MCP）通过标准输入/输出（stdin/stdout）
交流用于工具调用的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 不可用”信息

从 https://www.docker.com/products/docker-desktop 安装 Docker Desktop
确保 Docker Desktop 正在运行（系统托盘中应可见其图标）
如果Docker不可用，系统将自动回退到MCP模式

“使用备用端口 8001”消息

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

使用Docker模式时，初始启动较慢

首次运行时会下载ChromaDB Docker镜像（一次性，约100MB）
随后的启动速度比MCP模式更快
控制台日志中显示的进度

集装箱健康问题

系统自动重启不健康的容器
检查 Docker Desktop 中的容器状态
手动重启： docker restart mcp-memory-chromadb

🔄 MCP 模式问题（VITE_USE_DIRECT_CHROMA_ACCESS=false）

应用程序显示“无法连接到内存服务”

验证MCP内存服务是否已安装且可访问
检查一下那个 VITE_MEMORY_SERVICE_PATH 指向正确的目录
确保已安装UV包管理器（pip install uv)

仪表板操作缓慢

首次运行需要初始化ChromaDB（10-30秒）
后续操作速度更快（2-5秒）
这是向量数据库操作中的预期行为

增强的标签管理功能无法正常工作

确保您使用的是包含问题5修复的MCP内存服务v1.1.0+版本
验证增强的按标签删除功能是否可用
检查控制台日志（F12）以获取API兼容性消息

尽管有记忆，但统计数据却显示为0

等待仪表板完全初始化完成
检查ChromaDB路径是否具有适当的读/写权限
尝试点击刷新统计数据按钮

开发者工具自动打开

开发者工具默认是禁用的
根据需要，使用F12或Ctrl+Shift+I来切换

性能说明

初次启动ChromaDB初始化需要10-30秒
内存操作根据数据库大小，需2-10秒
统计数据检索对于大型数据库，带有真实查询时间追踪，耗时3-5秒
搜索行动1-3秒内得出实时结果并提供准确度指标
召回操作基于时间的过滤时间为1-3秒
创建备份2-10秒创建压缩的tar.gz文件
个别删除几乎即时，带有确认对话框

新功能故障排除（v1.2.0）

单个删除按钮未显示

确保内存条具有有效的ID（如有需要，请刷新搜索结果）
请确认您正在使用内存服务的最新版本
单个删除功能需要内存服务版本1.2.0或更高版本

基于时间的回溯功能未生效

先尝试更简单的表达：“今天”、“昨天”、“上周”
复杂的时态表达可能需要精确的措辞
检查控制台日志（F12）以查找时间解析错误

备份反馈未显示

验证备份目录具有写入权限
检查备份路径环境变量是否设置正确
大型数据库可能需要更长时间进行备份（进度显示中）

查询时间仍显示为0

进行几次搜索以填充平均值计算
查询时间跟踪至少需要一次搜索操作
如果指标未更新，请重启应用程序

寻求帮助

查看控制台日志（F12）以获取详细的错误信息
验证所有环境变量是否设置正确
确保MCP内存服务独立运行
检查数据库和备份目录的文件权限

🤝 贡献

我们欢迎投稿！请：

为仓库创建分支（或：克隆仓库）
创建一个特性分支（git checkout -b feature/amazing-feature）
提交您的更改（git commit -m 'Add amazing feature'）
推送至分支（git push origin feature/amazing-feature)
提交一个拉取请求

开发指南

遵循TypeScript的最佳实践
添加适当的错误处理
为复杂函数添加JSDoc注释
使用开发版本和生产版本进行测试
确保跨平台兼容性

📄 许可证

这个项目采用MIT许可证授权——详见许可证文件中详述。

🙏 致谢

“Anthropic”翻译成中文是“类人（的）”或“近似人类（的）”，具体含义需根据上下文来确定。在人工智能或计算机科学领域，它可能指的是与人类智能相似或接近的系统、算法或模型对于模型上下文协议规范
ChromaDB（可译为“色度数据库”，但具体翻译可能需根据上下文调整，若“ChromaDB”是特定产品或项目的名称，则可能需要保留原名或根据官方翻译进行调整）为向量数据库基金会（或：面向向量数据库基金会）
React 和 Electron 优秀文档社区
克劳德 在开发和调试方面提供帮助

📈 版本历史

v1.3.0（当前版本）- 🚀 专业方向：Docker与ChromaDB的集成

✅ Docker ChromaDB 模式高性能Docker容器集成，支持自动管理
✅（表示正确、对、确认或完成的符号） 2-3倍的性能提升直接HTTP访问消除了MCP的开销（响应时间50-150毫秒）
✅ MCP 冲突解决消除了干扰Claude Desktop的服务重复
✅ 零数据迁移卷挂载即时保存所有现有数据
✅ 表示“正确”或“对”。 优雅降级如果 Docker 不可用，则自动回退到 MCP 模式
✅（对号，表示正确、确认或完成） 容器生命周期管理健康监测、自动重启、优雅关闭
✅ 端口冲突解决自动端口选择，带备用端口
✅（对号，表示正确、同意或确认） 全面文档完整的安装指南和技术文档
✅ 生产就绪完整的测试套件，包含Docker集成验证
🔧 修理工/工具技术解决了GitHub问题#11（MCP重复）和#12（JS客户端限制）

v1.2.0 - 用户体验增强及问题#2解决

✅ 表示“正确”或“确认”。 真实查询时间追踪显示实际平均查询时间（1-3秒），而非0
✅ 完整备份系统带有详细反馈（路径、大小、时间戳）的真实tar.gz备份
✅ 个体记忆删除每个存储项上的删除按钮（🗑️）带有确认对话框
✅ 基于时间的回忆（或：按时间触发的回忆）新的“按时间召回”选项卡，配备快速过滤按钮和自然语言功能
✅ 4-Tab 界面存储 → 搜索 → 回忆（或“检索”）→ 标签管理，以实现更好的组织
✅ 增强用户体验（UX）丰富的通知、可关闭的成功消息以及实时更新
✅ 安全特性破坏性操作的确认对话框
✅ 性能指标真实查询时间测量与平均系统

v1.1.0 - 增强标签管理（问题#5解决）

✅ 翻译为中文是：✅（这个符号本身没有直接对应的中文翻译，它通常用作表示正确、确认或完成的标记，在中文语境中可直接保留或根据上下文解释为“正确”、“确认”或“完成”等意思。） 多重标签删除同时选择和删除多个标签
✅（这个符号通常表示“正确”、“对”或“确认”的意思，但无具体文字对应，若需文字表达，可译为“正确”或根据上下文译为“确认”等） 视觉标签界面具有添加/移除功能的交互式标签芯片
✅ 增强的用户体验（UX）具有搜索功能的统一界面
✅ API一致性解决了删除标签功能的歧义问题（问题5）
✅ 向后兼容性所有现有功能均保留
✅ 增强的警告清晰解释OR逻辑与AND逻辑的区别
✅ 翻译成中文是：✅（这个符号本身在中文中没有特定的含义，通常用作确认或正确标记，所以直接保留原样或根据上下文解释为“确认”、“正确”等）。如果只是单纯翻译这个符号，可以表示为“确认符号”或“正确符号”，但具体含义需结合上下文。 更好的错误处理增强用户反馈和验证

v1.0.0 - 核心功能

✅ MCP内存服务完全集成
✅ 对记忆数据执行完整的CRUD操作（创建、读取、更新、删除）
✅ 实时统计与健康监测
✅ 数据库备份和优化工具
✅ 使用Electron开发的专业桌面应用程序
✅ 响应式仪表盘界面
✅ 跨平台兼容性（macOS、Windows、Linux）
✅ 全面的错误处理和恢复机制

性能特性

内存容量支持通过语义搜索调用数千条记忆
搜索速度语义查询耗时1-3秒（现已准确追踪）
召回速度对于基于真实指标的时间查询，响应时间为1-3秒
数据库大小与ChromaDB向量存储高效扩展
启动时间初始10-30秒，随后2-5秒
备份创建根据数据库大小，时间在2到10秒之间

______________________________________________________________________

为MCP生态系统倾心打造

MCP Memory Dashboard

快速接入

详细介绍