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"]
    }
  }
}

구성 파일은 macOS의 ~/Library/Application Support/Claude/claude_desktop_config.json과 Windows의 %APPDATA%\Claude\claude_desktop_config.json에 있습니다.

uv 및 Python 3.10 이상이 필요합니다. 모든 MCP 클라이언트와 작동합니다.

Related MCP server: mcp-doc-search

도구

둘 다 메타데이터만 반환합니다.

하지 않는 일

이 도구는 무엇이든 삭제하거나, 이동하거나, 이름을 바꾸지 않습니다. 코드에는 쓰기 경로가 없습니다. 제안은 사용자에게 전달될 뿐이며, 사용자가 직접 Finder에서 실행해야 합니다.

이 도구는 파일을 읽을 수 없습니다. 이름, 크기, 타임스탬프만 컴퓨터 밖으로 나갑니다.

이 도구는 문서를 제거하도록 권장하지 않습니다. 여권, 비자, W2, 보험, 혼인, 증서 등 신원, 법률, 세금, 의료 관련 명칭과 일치하는 파일과 폴더는 합계에 포함되어 표시되지만, 정리 후보로 제안되지 않습니다. 이 보호는 하위 항목에도 상속되므로 Passport Renewal/ 안의 scan1.pdf 파일도 보호됩니다.

iCloud, Dropbox, OneDrive 같은 클라우드 동기화 폴더는 처리되지 않고 건너뜁니다. 디스크에서 크기와 타임스탬프가 의미 없기 때문입니다. 시스템 폴더, 앱 번들, 빌드 디렉터리도 건너뜁니다. 모든 검사는 무엇을 제외했는지 보고합니다.

알려진 한계

마지막 접근 시간은 사실이 아니라 힌트입니다. Spotlight, 백업, 바이러스 백신 소프트웨어가 이를 변경할 수 있고, 일부 볼륨은 완전히 추적을 중단할 수 있습니다. 서버가 접근 시간이 유지되고 않는 것을 감지하면 그렇게 알리고 수정 날짜로 대체합니다.

오래되고 다루지 않은 파일은 보관된 세무 기록과 정크 파일로 정확히 동일하게 설명합니다. 그 때문에 보호 목록이 있습니다. 하지만 목록이 모든 것을 잡아내는 것은 아닙니다. 삭제하기 전에 검토하십시오.

APFS 클론과 하드 링크는 디스크에서 블록을 공유합니다. 동일한 inode를 공유하는 파일은 한 번만 계산되므로 합계가 이중으로 계산되지 않지만, 클론된 파일의 복사본 하나를 삭제해도 나열된 크기보다 적은 공간이 확보될 수 있습니다.

검사는 기본적으로 50,000개 파일에서 중단되고 세 개 하위 폴더까지만 하향됩니다. 결과는 5분 동안 캐시되며, refresh를 전달하면 강제로 다시 검사합니다.

스크린샷 덤프와 거의 중복된 이미지는 아직 감지되지 않습니다. 정확한 중복 감지는 계획되어 있습니다.

라이선스

MIT