← 返回目录

TreeMap Disk Visualizer

社区

可视化并清理磁盘空间，安全回收每一字节。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 文件系统第 7 / 24
Stars: ★ 811 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js 20+
凭据: 无需凭据
许可证: MIT
最近提交: 今天
工具数: 8

62FMRS · C

TreeMap 是一个功能丰富的磁盘分析工具，通过 MCP 提供安全的 AI 驱动清理能力。其设计优先考虑数据安全，所有删除均可恢复，并严格限制 AI 仅能操作已扫描路径。适合希望以对话方式管理磁盘的用户。

最强项 · 文档质量 16/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

14/20

维护活跃度

14/20

文档质量

16/20

安装易用性

10/20

查看各项评分依据

可靠性 8/20: README声明了完整的MCP服务器（stdlib）和八个工具，但仓库中没有发现MCP特定的测试或CI验证其握手和工具列表。服务器路径（dist/mcp/index.js）需要构建步骤，但未看到构建输出或明确的测试证据。尽管有详细的API文档和架构描述，但静态审查缺乏可验证的执行证据，因此上限为12。
安全与权限 14/20: 安全性设计全面：所有删除操作仅移至系统回收站，拒绝扫描系统关键目录，路径防护和令牌桶限流。MCP工具要求先扫描才能操作，提供dryRun模式，并支持agent-policy.json限制。云扫描为可选且仅元数据，不下载文件内容。但未发现针对安全功能的自动化测试，且密码管理等敏感操作需要用户确认，但静态证据不足。
维护活跃度 14/20: 仓库活跃，有420星和0个开放问题，但未提及版本发布频率或贡献者活跃度。有MIT许可证和持续集成（GitHub Actions）迹象（release工作流），但未检查依赖更新频率或安全问题响应渠道。整体维护良好，但缺少更细致的证据。
文档质量 16/20: README非常详细，覆盖安装、MCP配置（Claude Desktop、Claude Code、Cursor等）、API参考、安全说明和设计决策。提供了MCP工具列表和示例。但缺少故障排除部分（如构建失败、依赖问题），且MCP部分仅提及setup，没有详细参数说明。文档证据充分，但可进一步改进。
安装易用性 10/20: MCP服务器需要Node 20+，克隆、安装依赖、构建，然后配置客户端。提供了多个客户端的配置示例，步骤清晰。但需要手动构建，且未提供现成的MCP服务器发布版本。静态审查无法验证安装过程，但文档提供了足够指导，因此上限为15。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件

适合谁

需要实时了解磁盘空间分布的用户。
希望 AI 协助进行磁盘清理和数据管理的用户。
需要跨平台（macOS、Windows、Linux）存储分析工具的用户。

不适合谁

需要永久删除文件（而非移入回收站）的用户。
需要对云存储进行内容级扫描（仅元数据）的用户。
希望无需安装 Node.js 即可使用 MCP 的用户。

所需权限

读取文件和文件夹元数据（如大小、路径）。
将文件移至系统回收站（通过系统 API，可恢复）。
访问系统回收站信息。
可选：在单独进程中监听局域网（Fleet 功能，默认关闭）。

风险与副作用

AI 可能误删重要文件，但删除仅进入系统回收站，可手动恢复。
AI 可能扫描包含敏感信息的文件夹，但这些信息仅本地处理，不会上传。
与云存储互动时，仅元数据，不会下载文件内容。
使用 offload 时，确保目标驱动器有足够空间，否则可能失败。

安装接入

准备工作

运行环境：Node.js 20+

确保已安装 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"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "treemap": {
      "command": "node",
      "args": [
        "/PATH/TO/TreeMap-Disk-Visualizer/dist/mcp/index.js"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add treemap -- node /PATH/TO/TreeMap-Disk-Visualizer/dist/mcp/index.js

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

构建后在 Claude Desktop 工具列表中应出现 treemap 服务器下的八个工具（如 scan_path、get_largest）；也可以在仓库目录运行 npm run mcp，应输出 server ready on stdio。

常见排障

如果 MCP 连接失败，检查 Node.js 版本（需 20+）。
确认 /PATH/TO/ 路径正确，dist/mcp/index.js 存在。
在客户端中重载 MCP 配置或完全重启应用。
检查终端中是否有错误输出（可尝试运行 `npm run mcp` 进行测试）。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

扫描我的 Downloads 文件夹，看看是什么占满了磁盘空间
找出我主目录里的重复文件并列出每组可回收的空间
这个磁盘按当前增长速度还要多久会满？
把最近一年没打开过的大视频移到外接硬盘，先用 dryRun 预览

工具能力 8

scan_path 只读

扫描一个文件夹，返回 scanId 供其他工具使用。

get_largest 只读

获取扫描中最大的文件或文件夹。

find_duplicates 只读

查找真正的重复文件（基于大小和 SHA-256 内容哈希）。

cleanup_suggestions 只读

列出可安全清理的空间：缓存、可再生的构建文件夹、垃圾文件。

forecast 只读

预测磁盘耗尽时间，例如“按当前增长速度，约 58 天后磁盘满”。

compare_scans 只读

比较两次扫描之间哪些文件增长或缩小了。

offload 破坏性

将文件安全迁移到另一驱动器：先复制、校验，再移入回收站。

trash_paths 破坏性

将文件移至系统回收站，绝不永久删除。

使用场景

“我的磁盘空间被什么占用了？”

“在下载文件夹中查找重复文件并清理。”

“这个磁盘还有多久会满？”

“把我的旧视频移到外置硬盘上。”

支持客户端

Claude Desktop

Claude Code

Cursor

依据项目文档列出，未经本站实测。

详细介绍

TreeMap 是一个跨平台磁盘空间可视化工具，可将磁盘占用以方形树状图等图表形式展示。通过 MCP，AI 助手可以扫描文件夹、查找大文件、识别重复内容、提供清理建议、预测磁盘耗尽时间，并安全地将文件移至系统回收站。所有删除操作均可恢复，且遵循严格的安全边界。