smart-tree로 먼저 로컬 디렉터리를 스캔한 뒤 MCP를 열기

누구에게 맞나

이 기기의 디렉터리 구조를 빠르게 보고, 같은 바이너리로 보안 스캔과 MCP 서비스를 하려는 사람을 위한 것이다. 공식은 Smart Tree를 blazingly fast, AI-friendly directory visualization tool이라고 쓰며, 전통 tree보다 10-24x 빠르고 Rust로 만들어졌으며 Security Scanner와 30+ MCP tools를 갖춘다.

Linux, macOS 또는 WSL에서 공식 설치 스크립트를 실행할 수 있고, 처음에는 설치 성공 확인과 기껏해야 읽기 전용 스캔 한 번만 하고 싶을 때 맞다. 첫 시도를 정리 삭제로 두지 마라.

이 프로그램이 현재 작업 영역 파일을 읽는 것을 받아들일 수 없으면 스캔을 실행하지 마라. 공식 페이지: https://github.com/8b-is/smart-tree

3분 만에 첫 시도

설치는 한 줄만 따른다: curl -sSL https://raw.githubusercontent.com/8b-is/smart-tree/main/scripts/install.sh | bash . 이것이 Linux/macOS/WSL의 one line install이다. 다른 설치기를 주 경로로 쓰지 마라.

전제: curl과 bash를 실행할 수 있고, 그 스크립트가 이 기기의 PATH와 바이너리를 바꾸는 것을 받아들인다. 설치 후 먼저 st --version으로 Verify installation을 한다. 버전 출력이 보인 뒤에 계속한다.

낮은 위험 호출은 st --security-scan . 다. 공식 설명은 Scan codebase for attack patterns이며 IPFS injection과 fake verification을 지목한다. 현재 디렉터리를 읽지만 페이지는 파일 삭제를 말하지 않는다. 적혀 있지 않은 매개변수를 넣지 마라.

성공 신호: 명령이 끝나고 스캔 결과 텍스트가 나오는 것이다. 공식 설명은 결과 필드를 나열하지 않았다. 어떤 종류의 경보가 보이지 않으면 페이지에 적혀 있지 않다고만 기록한다.

읽기 전용 스캔은 위험이 0이 아니다. 로컬 코드를 읽는다. 공식 설명은 네트워크 없음, 로컬 읽기 없음, 프라이버시 경계 없음을 선언하지 않았다.

사용 사례

사례 1: 현재 디렉터리의 공격 패턴을 스캔한다. 설치와 st --version 통과 후 대상 저장소 루트에서 st --security-scan . 을 실행한다. 페이지에 이미 적힌 공격 패턴으로만 출력을 이해하고 규칙 이름을 만들지 마라.

사례 2: 대화형 메뉴에서 MCP Server를 시작한다. 공식 메뉴 6번은 MCP Server이며 설명은 Model Context Protocol (stdio)다. 같은 표에 HTTP Daemon과 Custom Command도 있다. 페이지는 그 메뉴를 여는 명령을 쓰지 않았으므로 시작 인자를 만들지 마라. stdio 항목이 있다는 것만 확인한다. 30+ MCP tools도 개별 도구 이름이 없으니 호출을 만들지 마라.

사용 한계

설치 후 st --cleanup은 Scan and remove malicious MCP servers, hooks, and hidden directories이며 삭제 동작이다. st --cleanup -y는 Non-interactive cleanup (auto-confirm)이다. 처음에는 둘 다 쓰지 마라. 나중에 쓸 때는 제거될 대상을 먼저 확인하고, 페이지에 실행 취소 경로가 없음을 알아야 한다.

공식은 Security Scanner, Aye Consciousness, Spicy TUI도 언급하지만 대응하는 명령이나 스위치는 쓰지 않았다. 없으면 만들지 마라. 디렉터리 시각화 자체가 파일 시스템을 읽는다. MCP 서비스로 쓸 때도 이 기기 디렉터리 맥락을 드러낸다.