spacesentinel-mcp

Name: spacesentinel-mcp
Author: SheldonZhuang

本地服务

github.com/SheldonZhuang文件与存储112 周前更新

代码仓库

关于 spacesentinel-mcp

spacesentinel-mcp 是用于对话式磁盘清理和设备清理指南的 MCP 服务。Windows 清理仅限白名单位置；磁盘分析提供判断依据，是否删除始终由用户决定。

主要功能

01只读扫描 13 类垃圾文件
02确认后清理 Windows 白名单位置
03分析磁盘用量及目录归属依据
04提供 Windows、Mac、iOS、Android 清理指南
05指南支持 7 种语言

适用场景

01查找 Windows 上可释放的空间
02清理获准的临时文件和缓存
03查看目录依据后决定是否删除
04获取多语言设备清理步骤

MCP 相关

向 MCP 客户端提供 Windows 垃圾扫描、清理和磁盘分析工具，以及多语言设备清理指南。清理需要用户明确批准并确认。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "sheldonzhuang-spacesentinel": {
      "command": "npx",
      "args": [
        "-y",
        "spacesentinel-mcp"
      ]
    }
  }
}

启动命令npx -y spacesentinel-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmspacesentinel-mcp0.1.4stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

spacesentinel-mcp

SpaceSentinel 的 MCP 服务——面向 AI Agent（Claude Desktop、Cursor 等）的对话式磁盘清理工具。

工具

工具	平台	描述
`scan_junk`	Windows	只读扫描 13 类列入白名单的垃圾文件，并报告可释放的空间
`clean_junk`	Windows	清理白名单中的内容（需在用户明确批准后设置 `confirm=true`）
`analyze_disk`	Windows	只读磁盘归属分析：提供每个目录的证据（大小、PATH 引用、运行中的进程、已安装应用注册表、已知软件特征），帮助 AI 判断删除是否安全——始终由用户决定
`get_cleanup_guide`	全部	提供适用于 windows/mac/ios/android 的分步清理指南，支持 7 种语言

安全性：只会接触列入白名单的路径（临时文件、缓存、回收站）——绝不会触及 Documents、Desktop、Downloads 或 Photos。底层 PowerShell 工具是开源的，包含 Pester 测试覆盖，并具有防止删除路径逃逸的保护。

设置（Claude Desktop）

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "spacesentinel": {
      "command": "npx",
      "args": ["-y", "spacesentinel-mcp"]
    }
  }
}

或从本地克隆开始：

{
  "mcpServers": {
    "spacesentinel": {
      "command": "node",
      "args": ["D:/path/to/SpaceSentinel/mcp/index.js"]
    }
  }
}

然后向你的 Agent 提问：“扫描一下我电脑上的垃圾” / “如何释放 iPhone 上的空间？”

开发

npm install
node test-mcp.mjs   # protocol-level smoke test (initialize → tools/list → calls)

guides.json 和 CleanMyPC.ps1 从仓库根目录复制而来——上游内容变更后，运行 node ../tools/build-api.js && cp ../api/guides.json guides.json && cp ../tools/CleanMyPC.ps1 CleanMyPC.ps1 重新生成。

支持 Markdown

登录后评论