返回StorageRadar
集成

MCP 整合

让您的 AI 助手直接通过 Mac 上的安全、本地、只读端点查询 StorageRadar 分析。没有云。没有文件访问权限。您保持掌控。

只读 仅127.0.0.1 令牌认证 没有文件内容 没有删除

什么是MCP 集成？

当您在StorageRadar中启用MCP时，应用程序将在127.0.0.1上运行轻量级本地服务器。支持模型上下文协议的人工智能助手可以连接到该服务器并实时查询您的磁盘分析。

服务器是严格只读的。它可以回答诸如什么占用了最多空间或自上周以来发生了什么变化等问题，但它无法删除文件、移动任何内容或访问文件内容。

MCP 端点在所有层中均可用。启用它和查询数据是免费的。根据人工智能建议运行实际清理仍然需要StorageRadar中的适当解锁层。

设置指南

将您的 AI 连接到 StorageRadar 只需不到两分钟。

1

StorageRadar 中的开放集成

在侧栏中，单击集成。您将在屏幕顶部看到 MCP 部分。

2

启用MCP（只读）

打开启用MCP（只读）。状态指示灯变为“服务器正在运行”，StorageRadar 显示本地端点地址和端口。

3

生成您的访问令牌

单击生成令牌。将此令牌保密。您可以随时轮换它以撤销前一个。

4

复制配置片段并将其粘贴到您的 AI 客户端中

单击复制客户端配置片段。 StorageRadar 为您的 AI 客户端生成正确的配置格式。将其粘贴到客户端的MCP 服务器配置中。

5

首先运行扫描

确保您已在 StorageRadar 中运行至少一次扫描。 MCP 工具适用于索引扫描数据，因此空扫描历史记录意味着空结果。

提示示例

连接StorageRadar后，复制下面的任何提示并将其粘贴到您的AI助手中。 AI将调用适当的MCP工具并用简单的语言解释结果。

你的AI只能解释和推荐。要实际清理，请打开 StorageRadar 并使用其引导工作流程。人工智能分析和人为控制的清理在设计上是分开的。

01 快速连接检查
get_server_info
检查StorageRadar MCP 连接：显示服务器版本、API 版本、应用程序版本和所有可用功能。
serverVersion、apiVersion、appVersion、features[] — 确认连接正常工作。
02 最近的扫描会话
list_scan_sessions
显示我最近 10 个扫描会话，最新的在前。对于每个：日期、根卷、总大小（GB）、总项目数。
最近扫描的列表。从此处选择一个 sessionId 以便后续查询。
03 最新扫描细目
list_scan_sessionsget_scan_session
获取最近的扫描会话并显示其详细信息：顶级类别和大小直方图。解释一下空间去哪儿了。
按类别细分，并以简单语言解释磁盘使用结构。
04 最大的 30 个项目
largest_query
对于最近的扫描，显示前 30 个最大的项目，按从最大到最小的顺序排序。包括每个 GB 的大小和风险级别。
磁盘上最重的消费者，带有大小和风险标签。
05 最大的 20 个文件夹
largest_query
对于最近的扫描，仅显示前 20 个最大的文件夹，最小大小 500 MB，按大小降序排序。
可供在 Finder 中手动查看的最大文件夹。
06 按文件扩展名细分
largest_query
对于最近的扫描，显示按扩展名分组的总大小排名前 15 的文件类型。哪些文件类型占用的空间最多？
扩展分发，以便您可以查看视频、档案、构建工件或其他内容是否已填满您的磁盘。
07 用户与系统分类
largest_query
对于最近的扫描，显示按所有者分组的磁盘使用情况。我的空间与系统空间的份额是多少？解释一下细分情况。
用户和系统聚合可清晰分离您的数据与 macOS 文件。
08 列出已保存的快照
list_snapshots
显示我最近的 20 个磁盘快照：每个快照的 ID、日期、标签和总大小。首先排序最新的。
准备进行比较的快照列表。
09 为什么我的磁盘本周增长了？
list_snapshotsdiff_snapshots
拍摄最近的快照和距离 7 天前最近的快照。按类别进行比较并解释哪些增长最快。
具有简单语言增长解释的类别增量。
10 更新Xcode后发生了什么变化？
list_snapshotsdiff_snapshots
查找最接近日期 2026-02-15 的两个快照。在单独的查询中按扩展名和文件夹对它们进行比较。显示每个项目的增长最快的项目。
按文件夹和扩展名增长，通常显示DerivedData、模拟器和Xcode 缓存。
11 两个快照之间只有较大的变化
diff_snapshots
比较快照 [baseId] 和 [compareId]。仅显示大于 1 GB 的更改，限制 100。按类别分组。
只有噪音较小的显着变化。
12 开发缓存：最大的容量在哪里？
get_dev_cleanup_summary
显示最近扫描的开发清理摘要。按规模降序对配置文件进行排序，并突出显示前 5 名及其规模和风险级别。
Xcode、npm、Gradle、Docker 以及其他按大小排列的配置文件。
13 开发缓存按风险优先排序
get_dev_cleanup_summary
显示开发清理摘要并将所有配置文件分为安全、谨慎和高风险。建议首先清洁什么、清洁前要检查什么以及不要管什么。
具有风险意识的优先计划。
14 10步手动清理计划
largest_queryget_dev_cleanup_summary
根据最新的扫描和开发清理摘要，创建 10 个步骤的手动清理计划。从最安全和最大的候选者开始，到需要额外小心的项目结束。
您可以在StorageRadar中完成编号的行动计划。
15 检查路径隐私政策
largest_query
显示最近扫描的 largest_query 中的 10 项。对于每条路径，请注意它看起来是概括的还是详细的。当前的隐私政策似乎有效吗？
快速验证您的路径隐私策略设置是否按预期工作。
16 超过 5 个快照的磁盘增长趋势
list_snapshots
获取最后 5 个快照并构建简要趋势：每个日期的总磁盘大小、该期间的总增长以及平均每日增长率（以 MB/天为单位）。
显示磁盘填满速度的迷你时间线。
17 寻找异常增长峰值
list_snapshotsdiff_snapshots
比较最后 3 个连续的快照对。查找与其他时期相比增长突然且异常大的类别或文件夹。
具有时间戳的增长峰值候选者。
18 执行摘要
get_scan_sessiondiff_snapshotsget_dev_cleanup_summary
请给我一份关于我的Mac 存储的简短执行摘要：当前总磁盘大小、按类别排名前 3 位的消费者、自上次快照以来的增长情况以及按大小排序的 5 条安全清理建议。
没有过多细节的决策摘要。
19 完整的 Markdown 报告
get_scan_sessionlargest_querydiff_snapshotsget_dev_cleanup_summary
为最近的扫描构建 Markdown 报告。包括主要类别、前 10 个最大文件夹、按扩展名列出的前 10 个文件类型、按大小排序的开发清理摘要以及两个最新快照之间的关键更改。
准备保存的 Markdown 文档，用于笔记或事件跟踪。
20 验证MCP端到端连接
get_server_infotools/list
验证我的 StorageRadar MCP 端到端连接：初始化会话，列出所有可用工具，然后调用 get_server_info。显示通过的内容以及服务器返回的内容。
完整的运行状况检查，确认服务器正在运行、经过身份验证并准备就绪。

可用MCP工具

StorageRadar 在 MCP 上公开了七个只读工具。您的人工智能客户端可以根据您的问题自动调用这些。所有工具都支持基于游标的分页并返回稳定、确定的结果。

get_server_info 诊断

返回服务器版本、API 版本、应用程序版本和启用的功能列表。对于验证连接是否正常工作很有用。

返回值 serverVersionapiVersionappVersionfeatures[]
list_scan_sessions 扫描

列出所有扫描会话及其状态、根卷、范围和摘要统计信息。支持按日期范围和分页过滤。

参数 cursor limit from to
每个会话的返回值 idcreatedAtrootVolumescopestatustotalBytestotalItemsdurationMs
get_scan_session 扫描

返回特定扫描会话的详细元数据和聚合，包括按顶级类别划分的磁盘使用情况。

参数 id
返回值 metadatacategories[]histogram
largest_query 分析

通过灵活的分组返回扫描或快照中前 N 个最大的项目。用它来查找最大的文件、文件夹、扩展名或类别。

参数 sessionId snapshotId pathPrefix groupBy minBytes cursor limit
分组依据选项 itemfolderextensionownercategory
每个条目的返回值 keybytesitemsrisk
list_snapshots 快照

按时间顺序列出所有保存的磁盘快照。快照是从报告中手动捕获的，代表磁盘的某个时间点状态。

参数 cursor limit from to
每个快照的返回值 idcreatedAtlabelrootScopetotalBytes
diff_snapshots 快照

比较两个快照并返回它们之间增长、缩小、出现或消失的内容。按最小更改大小进行过滤，并按路径、扩展名或类别对结果进行分组。

参数 baseId compareId groupBy minDeltaBytes cursor limit
每个条目的返回值 keydeltaBytesdeltaItemsdirectionnotes
get_dev_cleanup_summary 开发清理

返回开发人员缓存和构建工件的聚合摘要。包括风险级别和提示。只读，无清理操作。

参数 sessionId snapshotId cursor limit
每个配置文件的返回值 profileIdnamebytesitemsriskLevelhints[]

分页限制

默认限制为 50，最大为 200。所有列表工具都返回用于获取下一页的光标。结果始终以稳定、确定的顺序返回。

安全性

仅环回

服务器专门绑定到127.0.0.1。没有 LAN 暴露，没有互联网访问。网络上的其他设备无法访问它。

需要令牌

每个请求都必须包含您的会话令牌。如果没有它，服务器将拒绝请求并记录尝试。您可以随时轮换令牌以撤销之前的访问权限。

速率有限

每个令牌的请求受到速率限制。这可以防止失控的人工智能代理攻击本地服务器。

完整的审核日志

每个工具调用都会在本地记录到 ~/Library/Application Support/StorageRadar/mcp-audit-log.json，其中包含时间戳、令牌 ID、工具名称、参数、响应大小、延迟和错误。

MCP 端点不能执行的操作

  • 删除或移动任何文件
  • 读取任意文件的内容
  • 访问网络或互联网
  • 调用不在批准列表中的任何工具
  • 执行或自动应用任何建议

隐私和数据最小化

StorageRadar 对MCP 响应遵循数据最小化策略。默认情况下，它返回通用路径，而不是公开确切的项目名称或个人目录名称。

默认（推荐）

通用路径

路径是在类别级别抽象的。例如：

而不是 ~/Library/Developer/Xcode/DerivedData/MySecretApp-xyz123
返回值 ~/Library/Developer/Xcode/DerivedData/*

这意味着您的人工智能可以获得有用的聚合数据，而不会泄露特定的项目名称或标识符。

可选

原始路径，已编辑的主页

在集成 → 路径隐私策略中启用原始路径（主页已编辑）以获取更详细的路径。启用后：

  • 返回更具体的路径以进行有针对性的诊断
  • 您的主目录始终替换为 ~
  • 长段和类似 ID 的字符串会自动屏蔽

在任何模式下都不会返回文件内容。这是一个硬约束。 MCP服务器没有读取或传输您的文档、图像、代码或任何其他文件的内容的机制。

配置片段

StorageRadar 自动为您的 AI 客户端生成正确的配置片段。单击集成屏幕中的复制客户端配置片段。以下是 Claude Desktop 的示例。

MCP 服务器在端口 7342 上使用 Streamable HTTP 传输。您的令牌位于 Authorization 标头中。不需要代理或 stdio 桥。

Claude Desktop / 任何JSON-配置客户端

将 storageradar 条目添加到客户端配置文件中的 mcpServers 对象：

claude_desktop_config.json 
{
  "mcpServers": {
    "storageradar": {
      "transport": "streamable_http",
      "url": "http://127.0.0.1:7342/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

将 <YOUR_TOKEN> 替换为集成中的令牌。单击“复制客户端配置片段”时，StorageRadar 会填写正确的值。

Claude Code (命令行)

如果您在终端中使用Claude Code，请使用一条命令注册服务器：

Claude Code (命令行) 
claude mcp add --transport http storageradar http://127.0.0.1:7342/mcp \
  --header "Authorization: Bearer <YOUR_TOKEN>"

连接后，请 AI 检查 StorageRadar MCP 连接，以验证其是否正常工作。它将调用 get_server_info 并显示服务器版本和可用功能。

轮换您的代币

随时单击 StorageRadar 中的“生成/轮换令牌”即可使当前令牌失效。之后更新客户端配置中的 Authorization 标头。任何使用旧令牌的请求都会立即返回403 AUTH_INVALID。