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:

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

Or from a local clone:

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

npm install
node 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