Spacesentinel Mcp

io.github.SheldonZhuang由 GitHub 账号 SheldonZhuang 发布v0.1.4更新于 Oct 24, 2026

Conversational Windows disk cleanup (whitelist-only) + device cleanup guides in 7 languages.

发布方自己的服务：Housing Sentinel

已验证STDIO仅桌面效率与工作流文件与存储

服务详情

标识符: io.github.SheldonZhuang/spacesentinel-mcp
传输: STDIO
运行时: Desktop only
信任: Verified
发布于: Sep 16, 2026

安全提示

MCP 服务会接收对话中的工具调用请求，并可能执行外部操作。启用前请先了解该服务能做什么，并只授予它所需的权限。

注册中心已验证此条目所属的 GitHub 账号 SheldonZhuang。这并不表明该账号就是产品方。

SourceWeft 的检查只涵盖条目是否完整、端点是否响应；不审查服务器的代码，也不审查其工具的行为。

在 README 中添加徽章

向读者展示该 MCP 服务已收录于 SourceWeft，徽章链接到本页。

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.SheldonZhuang%2Fspacesentinel-mcp.svg)](https://sourceweft.com/mcp/io.github.SheldonZhuang%2Fspacesentinel-mcp?utm_source=readme&utm_medium=badge)

概览

AI 生成的概览

SpaceSentinel 的本地 MCP 服务器，让助手扫描并清理 Windows 白名单垃圾文件，并提供各设备清理指南。

可以做什么: 扫描 Windows 上 13 类白名单垃圾文件，报告可回收空间（只读）。
仅在用户明确同意后，凭确认参数清理白名单内的内容。
按目录分析磁盘占用，结合大小、PATH 引用、运行中进程与注册表证据，由用户自行决定。
获取 Windows、macOS、iOS 和 Android 的分步清理指南，支持 7 种语言。
适用场景: 适合 Windows 用户希望助手找出可回收磁盘空间并安全引导清理时使用，也适合需要以自己语言获取手机、Mac 或电脑清理步骤的人。
运行要求: 作为本地 stdio 进程在用户机器上运行，通常通过 npx 启动 npm 包 spacesentinel-mcp（需要 Node.js），或用 node 从本地克隆启动。扫描、清理和磁盘分析工具需要 Windows，指南工具可在任意平台使用。未声明账号、API 密钥或环境变量。

安装前请注意

清理工具会删除文件，应仅在用户明确同意后运行，且只作用于临时文件、缓存和回收站等白名单路径。磁盘分析会读取本地目录、进程和注册表信息。确认删除前应检查助手提出的方案。

安装

在 SourceWeft 中

打开控制台中的 Spacesentinel Mcp，将其添加到工作区。
为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照仓库中的启动说明。

README

spacesentinel-mcp

MCP server for SpaceSentinel — conversational disk cleanup for AI agents (Claude Desktop, Cursor, etc.).

Tools

Tool	Platform	Description
`scan_junk`	Windows	Read-only scan of 13 whitelisted junk categories, reports reclaimable size
`clean_junk`	Windows	Cleans the whitelist (requires `confirm=true` after explicit user approval)
`analyze_disk`	Windows	Read-only disk-ownership analysis: per-directory evidence (size, PATH refs, running processes, installed-app registry, known-software signatures) so the AI can reason about what's safe to delete — the user always decides
`get_cleanup_guide`	All	Step-by-step cleanup guide for windows/mac/ios/android in 7 languages

Safety: only whitelisted paths are ever touched (temp files, caches, Recycle Bin) — never Documents, Desktop, Downloads or Photos. The underlying PowerShell tool is open source with Pester test coverage, including deletion-escape defenses.

Setup (Claude Desktop)

Add to claude_desktop_config.json:

json

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

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

Or from a local clone:

json

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

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

Then ask your agent: "扫描一下我电脑上的垃圾" / "How do I free up space on my iPhone?"

Development

guides.json and CleanMyPC.ps1 are copied from the repo root — regenerate with node ../tools/build-api.js && cp ../api/guides.json guides.json && cp ../tools/CleanMyPC.ps1 CleanMyPC.ps1 after upstream changes.

MIT © SheldonZhuang

来源：mcp/README.md，提交 a888797