Which integrations are available for this server?

Cleans Dart and Flutter caches such as .dart_tool and other build artifacts. Cleans Docker cache, including build cache and temporary files. Cleans npm cache and node_modules directories to free up disk space.

This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.

Clyan

by jonah791

Overview Schema Source Related Servers Discussions Admin

Python

Local

Clyan — AI-Driven Disk Cleaner v3.0.0 — 给 AI Agent 的磁盘本体感觉

自用非商用开源项目 · AGPL · 一个 AI 知道它"有多满"的磁盘工具

Clyan 不是"磁盘清理工具"。它是 AI Agent 的磁盘反射弧——像膝跳反射一样，在 AI 下载大文件之前自动腾出空间，在磁盘将满时自动预警，整个过程不需要 AI 思考"清理"这件事。

# 第一次：用手摸
clyan reclaim C:\           # 全量扫描 → 分阶段执行计划
clyan reclaim C:\ --phase 1 # 执行零风险阶段

# 第二次：条件反射
clyan pulse                  # <1ms 健康检查（缓存预热后零 IO）
clyan auto-clear             # 自动释放 cost=none 项（AI 无感）

一句话哲学

工具做"全"和"准"，AI 做"判断"和"决策"。

Clyan 不做三件事：

❌ 不替 AI 判断该删什么（删了 is_protected 硬拦截）
❌ 不按阈值决定删除方法（删了 _FAST_THRESHOLD）
❌ 不给 AI "加工"过的数据（全量原始信号返回）

Related MCP server: mcp-server-mint

三层架构

╔══════════════════════════════════════════════════╗
║  Layer 1  扫描层                                 ║
║  56 provider → 纯发现 path + size                ║
║  不做判断，不设等级                              ║
╠══════════════════════════════════════════════════╣
║  Layer 2  安全层 (自动)                           ║
║  ├  is_protected 通用过滤 (56/56)                ║
║  ├  SafetyLevel + age_days + tool_installed       ║
║  ├  would_break + recovery_cost + ecosystem      ║
║  └  confidence + 历史准确率回填                   ║
╠══════════════════════════════════════════════════╣
║  Layer 3  汇报层 (reclaim.py)                    ║
║  ├  _build_phases() → 结构化 JSON                ║
║  ├  Phase none/low/medium/high/unknown 执行计划   ║
║  └  recommendation 给 AI                        ║
╚══════════════════════════════════════════════════╝

### 全局 --json 标志

所有命令支持 `--json` / `-j` 参数，只输出纯 JSON 到 stdout。
人类可读信息输出到 stderr，不影响管道。

功能矩阵

🔍 扫描（53+ 内置 Provider + 3700+ Winapp2）

层	覆盖范围	provider 数
包管理器缓存	npm / pip / cargo / go / gradle / maven / nuget / pnpm / bun / uv	12
构建产物	node_modules / .next / .angular / .vite / .nx / target / build	20+ 模式
游戏/GPU	DirectX / NVIDIA / AMD / Intel 着色器缓存 + Steam / Epic 启动器	6
系统深度	Windows 事件日志 / 系统还原点 / 空目录 / 零碎小文件	5
IDE 缓存	VS Code / JetBrains / Eclipse / IDEA 扩展+缓存	5
浏览器	Chrome / Edge / Firefox 完整缓存 + SQLite 深度清理	4
Windows 系统	WinSxS / DISM / DriverStore / Installer / Update / Temp / WER / 缩略图 / 搜索索引	15
Windows 扩展	Delivery Optimization / SoftwareDistribution / Store / Teams / OneDrive / Defender / Xbox / 旧备份	8
应用缓存	Discord / Slack / Teams / Zoom / WeChat / Spotify / WhatsApp / Obsidian / Flutter / Android	12
ML/AI	HuggingFace Hub / Ollama / PyTorch / TensorFlow / LM Studio	5
Winapp2	社区维护 3700+ 条清理器定义（自动按路径分类）	动态
总计		56+ 固定 + 动态

级别	工具	延迟	AI 意识	行为
tick	`pulse`	<1ms（即时磁盘查询）	写文件前自动调用	无感
twitch	`auto-clear`	~30s（走全量 reclaim）	无感自动执行	只清 cost=none
spasm	`reclaim --phase`	~30s（全量）	被告知，不做决策	分阶段执行

历史清理记录会回填 provider 准确率（actual_freed / predicted），随扫描项输出为 historical_accuracy。（v3.0.0 起移除了行为学习调整——置信度只由静态信号 + 历史准确率决定。）

一次扫描，按风险分阶段输出：

📋  Reclaim Plan for <home>
   Total: 89.21 GB (364 items)
   🟢  Phase none:    28.97 GB (39 items)  — Temp/npx/缩略图
   🟡  Phase low:      1.12 GB (13 items)  — 浏览器缓存
   🟠  Phase medium:   4.52 GB (126 items) — IDE/构建产物
   🔴  Phase high:    25.95 GB (35 items)  — npm/pip/依赖缓存
   ⚫  Phase unknown: 28.65 GB (151 items) — Winapp2 未分类

性能

操作	实测（2026-08，C 盘）	说明
`pulse`（健康检查）	<1ms	即时磁盘查询，无缓存
`scan disk`（全盘概览）	~7s	depth=2
`scan dev-garbage`（开发者垃圾）	~8s	56 provider 并行
`reclaim`（全量回收计划）	~30s	无缓存，每次全量扫描
`auto-clear`（安全自动清理）	~30s	复用 reclaim 全量扫描
`duplicates`（重复文件检测）	~2s（4KB hash + 并行）	—
`doctor`（系统诊断）	~10s	8 项自检

快速开始

pip install -e .

clyan pulse                          # <1ms 健康检查
clyan auto-clear                     # 自动释放安全空间

clyan reclaim C:\                    # 全量扫描 → 分阶段计划
clyan reclaim C:\ --phase none       # 只执行零风险阶段



# MCP 服务器（给 AI Agent 用）
clyan mcp

命令参考

扫描

命令	说明
`scan space <path>`	目录空间分析（--depth, --top）
`scan dev-garbage <path>`	开发者缓存/垃圾 + Winapp2 + 置信度
`scan browsers`	浏览器缓存（Chrome/Edge/Firefox）
`scan system`	Windows 临时文件 + Temp 深度分解
`scan duplicates <path>`	重复文件（4KB hash + 并行 + inode 去重）
`scan packages`	包管理器环境检测
`scan disk [drive]`	磁盘概览：容量/已用/剩余/目录树/可回收
`scan files <path>`	大文件发现（--min-size, --top）
`scan node-waste <path>`	node_modules 内部瘦身
`scan quick <path>`	一键全量扫描

命令	说明
`pulse [path]`	磁盘健康检查（<1ms 即时查询）
`auto-clear [path]`	自动释放 cost=none 空间（进回收站）

命令	说明
`reclaim <path>`	全量扫描 → 分阶段执行计划
`reclaim <path> --phase none`	执行零风险阶段
`reclaim <path> --dry-run`	预览不执行

清理

选项	说明
`--dry-run`	预览（不删除）
`--deep --strategy safe`	一键深清：扫描→评分→过滤→执行→验证
`--dedupe keep-newest`	去重（保留最新）
`--auto-safe`	只删置信度≥90% 且 safety=safe
`--explain`	显示置信度原因 + 影响预警

其他

命令	说明
`history`	清理历史
`undo <id>`	撤销清理
`trust add/remove/list`	受信任路径（跳过保护警告）
`import winapp2 <file>`	导入 Winapp2.ini
`mcp`	启动 MCP 服务器（7 个 AI 感知工具）
`schedule --create`	每周定时清理

MCP 服务器（7 工具）

clyan mcp

工具	功能
`scan`	全量扫描：56 provider + system + browsers（`phase=full` 加 duplicates），返回带置信度/影响信号的 items
`scan_disk`	磁盘空间树 + 可回收概览
`clean_propose`	阶段 1：提议清理（返回 action_id + impact 预览，1 小时有效）
`clean_confirm`	阶段 2：按 action_id 确认执行（进回收站）
`system_health`	磁盘健康 + 趋势 + provider 准确率
`history`	清理历史查询
`undo`	撤销（恢复回收站项目）

推荐流程：scan → clean_propose → clean_confirm → history（可 undo）

AI 决策信号

每个扫描项返回的完整信号：

{
  "path": "<home>\\AppData\\Local\\pip\\cache",
  "size": 3380000000,
  "size_human": "3.38 GB",
  "provider": "python",
  "confidence": 0.50,
  "reason": "安全级别 SAFE；>90天未修改；工具仍在；已知缓存目录；重建成本高",
  "would_break": ["pip install would re-download all packages from PyPI"],
  "would_affect": ["pip", "python", "virtualenv"],
  "recovery_cost": "high",
  "ecosystem": "python",
  "age_days": 120,
  "tool_installed": true
}

字段	用途	示例
`confidence`	置信度 0.0–1.0	0.50
`reason`	中文评分原因	"安全级别 SAFE；>90天未修改…"
`would_break`	删除后果	["pip install would re-download…"]
`would_affect`	影响的应用	["pip", "python", "virtualenv"]
`recovery_cost`	恢复成本	"high" / "medium" / "low" / "none"
`ecosystem`	生态分组	"python" / "node" / "windows"
`age_days`	未使用天数	120
`tool_installed`	工具是否仍在	true

版本历程

版本	亮点
v2.0.0	三层架构重构 + 全量安全覆盖 + report.py 汇报层 + 56 provider
v0.19.0	Windows Installer 缓存 / DISM 集成 / npm 裁剪 / Winapp2 路径分类
v0.18.0	npm/pip 缓存深度分解（_npx / _cacache / 年龄分组）
v0.17.0	Winapp2 导入引擎（3700+ 社区清理器）
v0.16.0	历史准确率 + clean_plan MCP 工具
v0.15.0	信任系统 + system_health MCP
v0.14.0	Agent 反馈闭环 + clyan trust
v3.0.1	修复 v3.0.0 重构残留：reclaim/pipeline/scan disk 崩溃、npm_deep 死代码、trust 命令缺失、requirements 补全
v3.0.0	核心精简: 砍掉 learning/reflex/report (640行), 保留 7 MCP 工具，10,717→6,077 行
v0.13.0	影响预测（would_break / recovery_cost）+ 生态分组
v0.10.0	执行层精简：AI 全权决策
v0.7.0	置信度引擎（6 信号 + 重建成本）
v0.4.0	垃圾置信度评分
v0.2.0	Provider 并行化（~90% 提速）
v0.1.0	初始版本：26+ 检测器 + MCP

参考项目

项目	参考内容
Winapp2	3700+ 社区清理器定义
Czkawka	重复文件检测策略
ddh	轻量重复文件查找
bleachbit	安全边界模型
cache-commander	Provider 模块化架构 + MCP 集成
dustoff	JS/TS 构建产物清理
modclean	node_modules 深度瘦身

许可证

AGPL · 自用非商用开源

自用非商用开源项目（AGPL）。仅供个人学习、研究使用。禁止商业用途。

免责声明： 本工具会删除文件。虽然设计了多层安全保护，但不能保证 100% 避免误删。使用前请备份重要数据。作者不对因使用本工具造成的任何直接或间接损失承担责任。

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

Related MCP Connectors

khiveOAuth
ai.khive
Persistent memory, knowledge graph, task management and more for AI agents via MCP.
Knowledge & Memory Project Management
1
https://khive.ai/v1/mcp
Frenchie A
io.github.Lab94
OCR, transcription, file extraction, and image generation for AI agents via MCP.
AI & Machine Learning Image & Video Processing Speech Processing
72
https://mcp.getfrenchie.dev
OpenAkashic B
io.github.szara7678
Shared long-term memory vault for AI agents with 20 MCP tools.
Knowledge & Memory Autonomous Agents Agent Orchestration
3523
https://knowledge.openakashic.com/mcp/
LogRackOAuth
ai.lograck
Shared memory for your AI tools: tasks, notes and context every tool can read and write over MCP.
Knowledge & Memory Note Taking Project Management
1
https://mcp.lograck.ai/mcp

Related MCP Servers

cacheout-mcpofficial
File Systems OS Automation Developer Tools
cacheout-app
A
license
A
quality
C
maintenance
MCP server for macOS disk cache management. Enables AI agents to free disk space on demand by scanning and clearing developer caches.
Updated 3 months ago (2026-08-16 09:17 UTC)
13
22 PyPI
1
Sustainable Use v1.0
mcp-server-mint
File Systems OS Automation
dzg-studio
A
license
Not graded
quality
A
maintenance
Enables AI agents to use Mint as a safety layer for file operations on macOS, providing storage growth analysis, cleanup suggestions, and journaled, reversible deletions via MCP tools.
Updated a month ago (2026-10-01 20:12 UTC)
21 npm
MIT
sweep-mcp
Developer Tools File Systems
les-k
A
license
Not graded
quality
B
maintenance
Enables LLM agents to safely reclaim disk space by deleting build artifact directories like node_modules, .venv, and target, with strong guardrails to prevent accidental or malicious deletion.
Updated a month ago (2026-10-02 17:52 UTC)
MIT
SpaceLens MCP Server
File Systems Data Visualization
JingDuuu
A
license
Not graded
quality
A
maintenance
Enables local AI assistants to inspect Windows disk usage with treemap and folder X-ray views, retrieve cleanup previews, and receive application removal guidance, while exposing only non-destructive commands through MCP.
Updated 16 days ago (2026-10-17 07:06 UTC)
MIT