第三方工具更新 2026.11.14

Filesystem MCP 教學:讀取範圍與唯讀模式實測

用官方 Filesystem MCP 2.3.0 讀取合成檔案,測試目錄外拒絕與唯讀工具清單;限制範圍後再連接 AI 主機。

這裡的 Filesystem MCP 是 modelcontextprotocol/servers 的官方參考伺服器,npm 套件是 @modelcontextprotocol/server-filesystem。2.3.0 的測試允許讀取指定目錄的合成檔案、拒絕目錄外路徑;加上 --read-only 後,工具清單不再包含 write_file。這些是有限案例,不是完整安全稽核。

若需要分開檢查連線與工具回應,可用 MCP Inspector 的診斷流程;結構化記憶資料則可比較 Memory MCP 的保存方式。

先用專用測試目錄

建立 project/README.md,寫入 Dispatch NOTE-31 leaves at 08:30.。在 project 之外另建 outside.txt,內容只放合成文字。伺服器只能取得這個測試目錄,不要把家目錄或正在使用的工作區當成初始範圍。

版本與啟動條件

2.3.0 的套件宣告需要 Node.js 24 以上,本次實際使用固定 digest 的 Node 24 容器。以下使用絕對路徑。伺服器走 stdio,需要 MCP Client 傳送 tools/list 與 tools/call;單獨看到程序啟動訊息,還沒有驗證檔案可讀。

以下為 POSIX shell 指令;本次在 Linux 容器測試,未測 Windows shell。

npm install --ignore-scripts --save-exact @modelcontextprotocol/server-filesystem@2.3.0
node node_modules/@modelcontextprotocol/server-filesystem/dist/index.js --read-only /absolute/path/to/project

合法讀取、越界與唯讀

以 2025-03-26 協定初始化後,read_text_file 讀回 README 的已知句子。改讀 /tmp/outside.txt 時回傳 isError=true,內容指出路徑在允許目錄之外。另啟動 --read-only 的連線,tools/list 不包含 write_file。本次沒有要求 AI 自行挑選檔案,也沒有測寫入操作。

不能由這次測試推論的事

Roots 動態更新、--confine-roots、符號連結、--read-only-dir 與新版協定依官方文件 v2.3.0 整理,未本地實測。一般啟動模式具備寫入工具,不應因為這次只讀檔就視為唯讀。測試容器的根檔案系統唯讀與外網封鎖是另一層限制,不是這個套件自帶的效果。

官方來源與測試範圍

本次為 Codex 在無發布憑證、非 root、斷網容器執行的合成資料測試,不代表站長親測。套件版本為 2.3.0;文件快照為 e1dc4b18dbb9。

訂閱 AI 工具精選與使用建議

有值得推薦的新工具、實測發現或重要更新時,寄到你的信箱。

訂閱後先寄給你一份每月更新的 AI 工具與 Skill 清單。有值得推薦的工具、實測發現或重要更新時才寄信,隨時可以退訂。隱私權說明

快完成了,請到信箱收確認信點信裡的按鈕確認訂閱,就會收到工具清單的下載連結。沒看到的話,看一下垃圾郵件或「促銷內容」分頁。

也可以在這些平台追蹤: