适合谁
- 需要实时了解磁盘空间分布的用户。
- 希望 AI 协助进行磁盘清理和数据管理的用户。
- 需要跨平台（macOS、Windows、Linux）存储分析工具的用户。
T
62FMRS · C
TreeMap 是一个功能丰富的磁盘分析工具，通过 MCP 提供安全的 AI 驱动清理能力。其设计优先考虑数据安全，所有删除均可恢复，并严格限制 AI 仅能操作已扫描路径。适合希望以对话方式管理磁盘的用户。
TreeMap 是一个跨平台磁盘空间可视化工具，可将磁盘占用以方形树状图等图表形式展示。通过 MCP，AI 助手可以扫描文件夹、查找大文件、识别重复内容、提供清理建议、预测磁盘耗尽时间，并安全地将文件移至系统回收站。所有删除操作均可恢复，且遵循严格的安全边界。
工具能力
scan_path
扫描一个文件夹，返回 scanId 供其他工具使用。
get_largest
获取扫描中最大的文件或文件夹。
find_duplicates
查找真正的重复文件（基于大小和 SHA-256 内容哈希）。
cleanup_suggestions
列出可安全清理的空间：缓存、可再生的构建文件夹、垃圾文件。
forecast
预测磁盘耗尽时间，例如“按当前增长速度，约 58 天后磁盘满”。
compare_scans
比较两次扫描之间哪些文件增长或缩小了。
offload
将文件安全迁移到另一驱动器：先复制、校验，再移入回收站。
trash_paths
将文件移至系统回收站，绝不永久删除。
安装接入
- 确保已安装 Node.js 20+。
- 克隆仓库：git clone https://github.com/Prithvi-Web/TreeMap-Disk-Visualizer.git
- 进入目录：cd TreeMap-Disk-Visualizer
- 安装依赖：npm install
- 构建：npm run build
- 在支持 MCP 的客户端（如 Claude Desktop）中，将上述配置添加到 mcpServers，替换 /PATH/TO/... 为实际路径。
- 重启客户端。
claude_desktop_config.json
{
"mcpServers": {
"treemap": {
"command": "node",
"args": [
"/PATH/TO/TreeMap-Disk-Visualizer/dist/mcp/index.js"
]
}
}
}
选型与风险
不适合谁
- 需要永久删除文件（而非移入回收站）的用户。
- 需要对云存储进行内容级扫描（仅元数据）的用户。
- 希望无需安装 Node.js 即可使用 MCP 的用户。
所需权限
- 读取文件和文件夹元数据（如大小、路径）。
- 将文件移至系统回收站（通过系统 API，可恢复）。
- 访问系统回收站信息。
- 可选：在单独进程中监听局域网（Fleet 功能，默认关闭）。
风险与副作用
- AI 可能误删重要文件，但删除仅进入系统回收站，可手动恢复。
- AI 可能扫描包含敏感信息的文件夹，但这些信息仅本地处理，不会上传。
- 与云存储互动时，仅元数据，不会下载文件内容。
- 使用 offload 时，确保目标驱动器有足够空间，否则可能失败。
常见排障
- 如果 MCP 连接失败，检查 Node.js 版本（需 20+）。
- 确认 /PATH/TO/ 路径正确，dist/mcp/index.js 存在。
- 在客户端中重载 MCP 配置或完全重启应用。
- 检查终端中是否有错误输出（可尝试运行 `npm run mcp` 进行测试）。
使用场景
“我的磁盘空间被什么占用了？”
“在下载文件夹中查找重复文件并清理。”
“这个磁盘还有多久会满？”
“把我的旧视频移到外置硬盘上。”
支持客户端
Claude Desktop完整支持
Claude Code完整支持
Cursor完整支持