mcp-folder-scout

Спросите Claude, что находится в папке, что устарело и куда делось место.

Инструмент указывает на одну папку на вашем компьютере и сообщает имена, размеры и даты. Он не может читать содержимое файлов и не может перемещать или удалять что-либо.

> What's in my Downloads folder, and what haven't I opened in over a year?

771 files, 43.0 GB. Video is 96% of it.

Not opened in over a year: 102 files, 15.3 GB, almost all of it
video — Barclay lake (27 clips, ~12 GB) and Big (2 clips, 2.5 GB).
If those are backed up elsewhere, they're the obvious candidates.

76 files matched identity, legal, tax, or medical naming and were
excluded from the suggestions above.

Установка

claude mcp add --scope user folder-scout -- uvx mcp-folder-scout

Для Claude Desktop добавьте это в claude_desktop_config.json и перезапустите:

{
  "mcpServers": {
    "folder-scout": {
      "command": "uvx",
      "args": ["mcp-folder-scout"]
    }
  }
}

Файл конфигурации находится в ~/Library/Application Support/Claude/claude_desktop_config.json на macOS и в %APPDATA%\Claude\claude_desktop_config.json на Windows.

Требуются uv и Python 3.10+. Работает с любым MCP-клиентом.

Related MCP server: mcp-doc-search

Инструменты

Оба возвращают только метаданные.

Чего он не будет делать

Он не может ничего удалять, перемещать или переименовывать. В коде нет пути записи. Рекомендации выдаются вам; вы сами действуете по ним в Finder.

Он не может читать ваши файлы. Ваши данные покидают компьютер только в виде имён, размеров и меток времени.

Он не будет рекомендовать удалять ваши документы. Файлы и папки, имена которых относятся к удостоверяющим личность, юридическим, налоговым или медицинским документам — паспорт, виза, форма W2, страховой полис, свидетельство о браке, документ о праве собственности и другие, — учитываются в итогах и помечаются, но никогда не предлагаются как кандидаты на очистку. Эта защита действует и на вложенные папки, поэтому файл scan1.pdf внутри Passport Renewal/ также защищён.

Синхронизируемые облачные папки (iCloud, Dropbox, OneDrive) пропускаются, а не обрабатываются, потому что их размеры и метки времени на диске бессмысленны. Системные папки, пакеты приложений и каталоги сборки тоже пропускаются. Каждое сканирование сообщает, что было исключено.

Известные ограничения

Время последнего доступа — это подсказка, а не факт. Spotlight, резервные копии и антивирусы могут изменять его, а некоторые тома вообще перестают его отслеживать. Когда сервер обнаруживает, что время доступа не поддерживается, он сообщает об этом и переключается на даты изменения.

Старые и нетронутые данные характерны как для архивных налоговых документов, так и для хлама. Для этого и существует защищённый список, но он не охватит всё. Проверяйте результаты перед удалением.

Клоны APFS и жёсткие ссылки делят блоки на диске. Файлы с общим inode учитываются один раз, поэтому при подсчёте не возникает двойного счёта, однако удаление одной копии клонированного файла может освободить меньше места, чем указанный размер.

По умолчанию сканирование останавливается на 50 000 файлах и углубляется на три уровня. Результаты кэшируются в течение пяти минут; передайте refresh, чтобы принудительно выполнить повторное сканирование.

Скопления скриншотов и почти идентичные изображения пока не распознаются. Определение точных дубликатов запланировано.

Лицензия

MIT