MCP

用 smart-tree 先掃本地目錄再開 MCP

適合在 Linux/macOS/WSL 用官方 install.sh 裝好後,先跑 st --version 再用 st --security-scan . 看攻擊模式;st --cleanup 會刪除可疑整合,不要當第一次呼叫。

官方來源 · smart-tree

安裝

curl -sSL https://raw.githubusercontent.com/8b-is/smart-tree/main/scripts/install.sh | bash

適合誰

面向要在本機快速看目錄結構、並願意用同一套二進位做安全掃描與 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。這會讀目前目錄,但頁面沒有說它會刪除檔案。不要加未寫出的參數。

成功訊號:命令結束並給出掃描結果文本。官方說明沒有列出結果欄位;看不到某類告警時,只記為頁面未寫到。

唯讀掃描不是零風險。它會讀本地程式碼。官方說明沒有聲明無網路、無本機讀取或無隱私邊界。

使用案例

案例一:掃描目前目錄的攻擊模式。安裝並 st --version 通過後,在目標倉庫根目錄執行 st --security-scan . 。只根據頁面已寫的攻擊模式理解輸出,不要編造規則名。

案例二:從互動選單啟動 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 服務時,同樣會暴露本機目錄上下文。