spacesentinel-mcp

spacesentinel-mcp

SpaceSentinel 用 MCP サーバー — AI エージェント（Claude Desktop、Cursor など）向けの会話形式のディスククリーンアップです。

ツール

ツール	プラットフォーム	説明
scan_junk	Windows	ホワイトリストに登録された 13 種類の不要ファイルを読み取り専用でスキャンし、解放可能な容量を報告します
clean_junk	Windows	ホワイトリストの項目をクリーンアップします（ユーザーの明示的な承認後に confirm=true が必要です）
analyze_disk	Windows	ディスクの所有状況を読み取り専用で分析します。ディレクトリごとの根拠（サイズ、PATH 参照、実行中のプロセス、インストール済みアプリのレジストリ、既知ソフトウェアのシグネチャ）を示し、AI が安全に削除できるものを判断できるようにします。削除するかどうかは常にユーザーが決定します
get_cleanup_guide	All	Windows／Mac／iOS／Android 向けの手順付きクリーンアップガイドを 7 言語で提供します

安全性：操作対象はホワイトリストに登録されたパス（テンポラリファイル、キャッシュ、ごみ箱）のみです。ドキュメント、デスクトップ、ダウンロード、写真には決して触れません。基盤となる 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"]
    }
  }
}

次に、エージェントに「パソコンの不要ファイルをスキャンして」／「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 を実行して再生成してください。

MIT © SheldonZhuang