mac-cleaner-mcp

Консервативный очиститель macOS для разработчиков/хранилища, предоставляемый через официальный TypeScript SDK Model Context Protocol. Это не полный оптимизатор диска: он сначала сообщает, отказывается от широких деструктивных мест и поддерживает пробные запуски.

Инструменты

• scan_junk: DerivedData, iOS DeviceSupport, кэш Gradle/Android, кэш Homebrew, кэш пакетов Node, освобождаемое пространство Docker, ~/Library/Caches, большие файлы в Downloads (>100 МБ) и обнаруженные node_modules.

• clean_junk: принимает категории и по умолчанию использует dryRun: true. Очищать можно только DerivedData, DeviceSupport, Android/Gradle, Homebrew и Docker. Downloads, node_modules и широкие корни кэша намеренно отклоняются.

• get_disk_usage: запускает df для выбранного пути.

Related MCP server: cacheout-mcp

Установка и запуск

Требуется macOS, Node.js 20+ и, опционально, Docker. Не запускайте от имени root.

git clone https://github.com/FFFames/mac-cleaner-mcp.git
cd mac-cleaner-mcp
npm install
npm run build
node dist/index.js

MCP использует stdio, поэтому процесс должен запускаться MCP-клиентом. Очистка может удалять файлы; проверьте вывод пробного запуска и делайте резервные копии перед установкой dryRun: false.

Claude Desktop / Cursor

Добавьте абсолютный путь к dist/index.js в конфигурацию MCP клиента:

{"mcpServers":{"mac-cleaner":{"command":"node","args":["/ABSOLUTE/PATH/mac-cleaner-mcp/dist/index.js"]}}}

Перезапустите клиент, вызовите scan_junk, затем вызовите clean_junk с выбранными категориями и dryRun: true. Используйте false только после просмотра результата. Cursor поддерживает ту же конфигурацию stdio MCP-сервера через свои настройки MCP.

Poke / remote bridge

Для локального моста, совместимого с Poke, запустите этот сервер как дочерний процесс и проксируйте MCP JSON-RPC stdin/stdout через аутентифицированную HTTPS-конечную точку. Простой вариант — SSH/HTTP-мост или ngrok перед вашим собственным процессом моста:

ngrok http 8787

Настройте вышестоящую команду моста как node /ABSOLUTE/PATH/mac-cleaner-mcp/dist/index.js, затем зарегистрируйте HTTPS-URL ngrok в вашем соединении Poke/MCP. Никогда не открывайте неаутентифицированную конечную точку; используйте токен аутентификации ngrok, разрешите список вызывающих и меняйте URL/токен. Сам очиститель работает только локально и не имеет сетевого слушателя.

Безопасность

Реализация использует явные списки разрешенных категорий, без раскрытия подстановочных знаков оболочки, по умолчанию пробный запуск, и отказывается от Downloads, node_modules и всего корня пользовательского кэша. Просмотрите исходный код и протестируйте на некритичной учетной записи перед использованием.