mac-cleaner-mcp

공식 Model Context Protocol TypeScript SDK를 통해 제공되는 보수적인 macOS 개발자/저장 공간 정리 도구입니다. 전체 디스크 최적화 도구는 아닙니다. 먼저 보고하고, 광범위한 파괴적 위치를 거부하며, 드라이 런(dry run)을 지원합니다.

도구

• scan_junk: DerivedData, iOS DeviceSupport, Gradle/Android 캐시, Homebrew 캐시, Node 패키지 캐시, Docker 회수 가능 공간, ~/Library/Caches, 대용량 Downloads 파일(>100MB), 그리고 발견된 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

클라이언트의 MCP 구성에 dist/index.js의 절대 경로를 추가하십시오:

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

클라이언트를 다시 시작하고 scan_junk를 호출한 다음, 선택한 카테고리와 dryRun: true로 clean_junk를 호출하십시오. 결과를 검토한 후에만 false를 사용하십시오. Cursor는 MCP 설정을 통해 동일한 stdio MCP 서버 구성을 지원합니다.

Poke / 원격 브리지

로컬 Poke 호환 브리지의 경우, 이 서버를 자식 프로세스로 실행하고 인증된 HTTPS 엔드포인트를 통해 MCP JSON-RPC stdin/stdout을 프록시하십시오. 간단한 옵션은 자체 브리지 프로세스 앞에 SSH/HTTP 브리지 또는 ngrok을 두는 것입니다:

ngrok http 8787

브리지의 업스트림 명령을 node /ABSOLUTE/PATH/mac-cleaner-mcp/dist/index.js로 구성한 다음, HTTPS ngrok URL을 Poke/MCP 연결에 등록하십시오. 인증되지 않은 엔드포인트를 절대 노출하지 마십시오. ngrok 인증 토큰을 사용하고, 호출자를 허용 목록에 추가하며, URL/토큰을 교체하십시오. 클리너 자체는 로컬 전용이며 네트워크 리스너가 없습니다.

안전

구현은 명시적 카테고리 허용 목록을 사용하고, 셸 와일드카드 확장이 없으며, 기본적으로 드라이 런을 사용하고, Downloads, node_modules, 전체 사용자 캐시 루트를 거부합니다. 사용 전에 소스를 검토하고 중요하지 않은 계정에서 테스트하십시오.