Disk Clean

磁盘清理 MCP 服务

日本語 | English

让 Claude 或其他 AI 助手帮你“清理我的磁盘”。此 MCP 服务会找出占用磁盘空间的文件，并将它们移到废纸篓。

• 不会删除任何内容。项目会移到操作系统的废纸篓，以便之后恢复
• 你会先看到列表，只有你批准的项目才会被移动
• 绝不会触碰系统文件夹

支持的操作系统：macOS / Linux / Windows

可查找的内容

类型	示例
开发者缓存	node_modules、__pycache__、Rust target/、build/ 和 dist/、Python 虚拟环境（.venv）、~/.gradle/caches、~/.cargo/registry
大型未使用视频	.mp4、.mov、.mkv 等超过 100 MB，且 90 天内未打开或更改过的视频
旧日志	30 天内未更新的 .log 和 .log.gz 文件

你可以在请求中更改大小和时间限制（例如“超过 500 MB 的视频”或“一年以上的日志”）。

---

安装

Claude Desktop（最简单）

1. 从 Releases 下载最新的 diskclean-mcp-server-*.mcpb
2. 双击该文件，或将其拖入 Claude Desktop 的 设置 → 扩展
3. 点击 安装

Claude Desktop 会为你配置 Python 和其他所有内容。

其他应用（Claude Code、Cline、手动设置）

这些应用使用 uv 下载并运行服务。你无需自行安装 Python。

步骤 1：安装 uv

macOS / Linux：

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows（PowerShell）：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

打开新的终端，并检查 uv --version 是否正常运行。

步骤 2：将服务添加到应用中

Claude Code

claude mcp add --scope user diskclean -- uvx diskclean-mcp-server

--scope user 会让它在每个项目中都可用。

可选：安装技能，让 Claude 学习安全清理步骤。

mkdir -p ~/.claude/skills/disk-cleanup
curl -fsSL https://raw.githubusercontent.com/Kate941-su/diskcleaner-mcp/main/.claude/skills/disk-cleanup/SKILL.md \
  -o ~/.claude/skills/disk-cleanup/SKILL.md

Claude Desktop（手动设置）

打开配置文件：

操作系统	配置文件
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json

添加以下内容并重启 Claude Desktop：

{
  "mcpServers": {
    "diskclean": {
      "command": "uvx",
      "args": ["diskclean-mcp-server"]
    }
  }
}

Cline（VS Code）

在 Cline 的 MCP Servers 页面中打开配置文件，并添加与上文相同的条目。

---

使用方法

用自然语言向助手提出请求：

My disk is full. Find files I don't need in my home folder.

Clean up all the node_modules folders under ~/projects.

Find videos in ~/Movies over 1 GB that I haven't watched in six months.

Show me what is using space in ~/Library/Caches, two levels deep.

工作流程

1. 助手会查看文件夹，并告诉你哪些内容占用了空间
2. 你会看到候选项目列表（路径、类型、大小、最后修改时间）以及可释放的总空间。此时尚未移动任何内容
3. 告诉助手要移动哪些内容（“全部”“仅 node_modules”“除了 #3 以外的所有内容”）
4. 只有获批的项目会被移到废纸篓，之后你会收到一份报告

恢复文件

所有内容都会移到废纸篓，你可以随时将其恢复。

• macOS：在 Finder 中打开废纸篓，右键点击项目并选择 放回原处
• Windows：打开回收站，右键点击项目并选择 还原
• Linux：在文件管理器中打开废纸篓，并选择 还原（存储于 ~/.local/share/Trash）

清空废纸篓后，磁盘空间才会真正释放。

绝不会移动的内容

• 操作系统系统文件夹（/usr、/System、C:\Windows、C:\Program Files 等）
• 你的主文件夹本身，以及磁盘根目录下的直接子文件夹
• 不在已展示列表中的任何内容
• 符号链接（以及它们指向的文件）
• 不属于你的项目，而是属于工具和应用的 node_modules 和虚拟环境：pnpm 存储目录、由 nvm 安装的 Node.js、VS Code 扩展，以及 ~/Library、~/AppData 或主文件夹中隐藏文件夹内的任何内容。移除这些内容会导致工具无法正常工作

只有在 build/ 和 dist/ 旁边存在 package.json 等构建文件时，它们才会被视为缓存，因此不会误将同名的普通文件夹列入其中。

---

更新

Claude Desktop 扩展：从 Releases 下载新的 .mcpb 并重新安装。

使用 uvx：uv 会缓存副本。要获取最新版本，请运行以下命令并重启应用。

uv cache clean diskclean-mcp-server

若要始终启动最新版本，请改用 "args": ["diskclean-mcp-server@latest"]。每次服务启动时都会检查更新。

---

故障排除

助手中没有显示这些工具

• 更改设置后重启应用
• Claude Desktop 可能找不到 uvx。请将完整路径填入 "command"。在 macOS / Linux 上使用 which uvx 查找，在 Windows 上使用 where uvx
• 在 Claude Code 中，使用 claude mcp list 检查

“无法读取某些文件夹”（skipped_errors）

• 无权读取的文件夹会被跳过。在 macOS 上，授予应用完全磁盘访问权限可能会有帮助（系统设置 → 隐私与安全性）

扫描提前停止（timed_out）

• 单次扫描最长运行 60 秒。请指定较小的文件夹，例如 ~/projects

---

开发者须知

设计、工具规范、开发环境设置和发布流程（以日语编写）请参阅 docs/DESIGN.md。

许可证

MIT