Spacesentinel Mcp

io.github.SheldonZhuangPublished by GitHub account SheldonZhuangv0.1.4Updated Oct 24, 2026

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

The publisher's own server: Housing Sentinel

Overview

AI-generated overview

Local MCP server for SpaceSentinel that lets an assistant scan and clean whitelisted Windows junk files and give device cleanup guides.

What you can do
  • Scan 13 whitelisted junk categories on Windows and report reclaimable space (read-only).
  • Clean the whitelist only after explicit user approval, with a confirm flag.
  • Analyze disk ownership per directory using size, PATH references, running processes and registry evidence, leaving the decision to the user.
  • Fetch step-by-step cleanup guides for Windows, macOS, iOS and Android in 7 languages.
When to use it
Useful when a Windows user wants an assistant to find reclaimable disk space and walk through cleanup safely, or when someone needs guided cleanup steps for a phone, Mac or PC in their own language.
Requirements
Runs as a local stdio process on the user's machine, typically launched with npx from the npm package spacesentinel-mcp (Node.js required) or from a local clone with node. Windows is needed for the scan, clean and disk-analysis tools; the guide tool works on any platform. No accounts, API keys or environment variables are declared.
Before you install
The clean tool deletes files, so it should only run after explicit user approval; it is limited to whitelisted paths such as temp files, caches and the Recycle Bin. Disk analysis reads local directory, process and registry information. Review what the assistant proposes before confirming any deletion.

Installation

In SourceWeft

  1. Open Spacesentinel Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

spacesentinel-mcp

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

Tools

ToolPlatformDescription
scan_junkWindowsRead-only scan of 13 whitelisted junk categories, reports reclaimable size
clean_junkWindowsCleans the whitelist (requires confirm=true after explicit user approval)
analyze_diskWindowsRead-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_guideAllStep-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"]    }  }}

Or from a local clone:

json
{  "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

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

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

Source: mcp/README.md at commit a888797

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.4LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.

Other Housingsentinel integrations