diskcleankit-mcp

DiskCleanKit MCP 服务

MCP（Model Context Protocol）服务，让 Claude 等 AI 助手能够控制 DiskCleanKit 的 One Touch 功能，清理 Mac 磁盘。

前提条件

• macOS
• 已安装 DiskCleanKit 应用
• Node.js v18+

安装

通过 npm 安装（推荐）

npm install -g @vannamtran/diskcleankit-mcp

从源代码安装

git clone https://github.com/namtran/diskcleankit-mcp
cd diskcleankit-mcp
npm install
npm run build

配置

Claude Desktop

将配置添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "diskcleankit": {
      "command": "npx",
      "args": ["@vannamtran/diskcleankit-mcp"]
    }
  }
}

然后重启 Claude Desktop。

Claude Code（CLI）

claude mcp add --transport stdio diskcleankit -- npx @vannamtran/diskcleankit-mcp

或者编辑 ~/.claude/settings.json：

{
  "mcpServers": {
    "diskcleankit": {
      "command": "npx",
      "args": ["@vannamtran/diskcleankit-mcp"]
    }
  }
}

Cursor

将配置添加到 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目专用）：

{
  "mcpServers": {
    "diskcleankit": {
      "command": "npx",
      "args": ["@vannamtran/diskcleankit-mcp"]
    }
  }
}

或者前往 Cursor 设置 → 工具与集成 → 新建 MCP 服务。

VS Code（GitHub Copilot）

将配置添加到 settings.json：

{
  "mcp.servers": {
    "diskcleankit": {
      "command": "npx",
      "args": ["@vannamtran/diskcleankit-mcp"]
    }
  }
}

其他 MCP 客户端

客户端	配置文件
Cline	VS Code 扩展设置
Windsurf	~/.windsurf/mcp.json
Zed	~/.config/zed/settings.json
Continue	~/.continue/config.json

使用相同的配置结构：

{
  "mcpServers": {
    "diskcleankit": {
      "command": "npx",
      "args": ["@vannamtran/diskcleankit-mcp"]
    }
  }
}

Ollama（通过 mcphost）

Ollama 原生不支持 MCP，但你可以使用 mcphost：

pip install mcphost
mcphost -m ollama:qwen2.5 --config config.json

不支持的平台

• ChatGPT：不原生支持 MCP

可用工具

工具	说明
one_touch_scan	扫描垃圾文件（安全，不会删除）
one_touch_clean	推荐 - 自动扫描并清理垃圾文件
get_disk_status	检查磁盘空间和健康状态
get_cleanable_estimate	按类别估算可清理的空间
get_cleaning_history	查看以往的清理记录

清理内容

one_touch_clean 会自动扫描并清理仅限安全项目：

类别	说明
系统缓存	macOS 系统缓存文件
应用缓存	应用生成的缓存文件
应用日志	应用生成的旧日志文件
浏览器缓存	Safari、Chrome、Firefox 缓存

这些文件都可以安全删除，系统/应用会在需要时重新生成。

使用示例

配置完成后，可以向 AI 助手提出以下请求：

• “扫描我的 Mac，查找垃圾文件” → one_touch_scan
• “清理我的 Mac” → one_touch_clean
• “我的磁盘还剩多少空间？” → get_disk_status
• “有哪些内容可以清理？” → get_cleanable_estimate
• “显示我的清理记录” → get_cleaning_history

工作原理

AI Assistant → MCP Server → URL Scheme → DiskCleanKit App
                   ↑                            ↓
              JSON Response ← Temp File ← Response

1. AI 调用 MCP 服务工具
2. MCP 服务通过 diskcleankit:// URL 方案触发 DiskCleanKit
3. DiskCleanKit 处理请求，并将响应写入 /tmp/diskcleankit_mcp_response.json
4. MCP 服务读取响应并返回给 AI

安全性

• one_touch_scan 安全可靠——只扫描，不会删除
• one_touch_clean 会自动扫描并清理安全项目（仅缓存和日志）
• 只清理可重新生成的文件，不会触及个人数据或文档
• 所有处理都在你的 Mac 本地进行
• 不会向外部服务发送数据

**注意：**可以直接运行 one_touch_clean，它是安全的——只会移除系统/应用缓存和日志，这些内容会自动重新生成。

故障排除

“等待响应超时”

• 确认已安装 DiskCleanKit 应用
• 先尝试手动打开 DiskCleanKit

Claude 中未显示服务

• 确认配置路径正确
• 更改配置后重启 Claude Desktop
• 检查 Claude 日志中是否有错误

许可证

MIT

链接

• DiskCleanKit 应用
• MCP 协议