磁盘清理控制协议服务器

DiskCleanKit MCP服务器

MCP（模型上下文协议）服务器，使Claude等AI助手能够控制DiskCleanKit的 触动 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

配置

克劳德桌面版

添加 ~/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。

克劳德代码（CLI）

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

或编辑 ~/.claude/settings.json:

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

光标

添加 ~/.cursor/mcp.json （全球）或 .cursor/mcp.json （项目特定）：

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

或前往 光标设置→ 工具和集成→ 新建MCP服务器.

VS代码（GitHub副本）

添加到您的 settings.json:

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

其他MCP客户端

使用相同的配置结构：

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

奥利马（通过mcphost）

Olama本身不支持MCP，但您可以使用 mcphost:

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

不支持

• ChatGPT：不支持原生MCP

可用工具

什么被清理

one_touch_clean 自动扫描和清理 仅限安全物品:

这些都可以安全删除，并将由系统/应用程序根据需要重新生成。

使用示例

配置后，询问您的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 diskcleankit:// URL方案
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日志是否有错误

许可证

麻省理工学院

链接

• 软盘应用程序
• MCP协议