MCP 官方伺服器改採 SemVer 並全面強化安全:non-root Docker 與 v2.4/v2.5 修復一次看
Model Context Protocol 官方伺服器倉庫近期從日期版號轉向語意化版本(SemVer),並在 v2.4.0 與 v2.5.0 修復多項 Git 與檔案系統高風險漏洞,同步導入 non-root Docker 執行機制。
當大型語言模型開始透過工具存取本機檔案、版本庫與外部網頁時,Model Context Protocol(MCP)已經成為 AI 代理串接外部環境的共同標準。對一般開發者來說,MCP 就像是一組標準化的「外接插槽」,讓不同的 AI 客戶端都能用一致的協定呼叫外部工具。不過,當越來越多人把官方示範伺服器直接放進自動化流程甚至容器環境中運行,權限邊界與版本管理就成了開發團隊無法迴避的課題。
為了回應這波工程化需求,GitHub 上累積超過 9.2 萬顆星的官方參考實作儲存庫 modelcontextprotocol/servers 近期接連推出關鍵調整。除了在 Docker 映像檔全面導入非 root 使用者(non-root Docker)執行機制外,TypeScript 系列套件也正式從過去的日期版號轉向語意化版本(SemVer),並接連在 2026 年 11 月 11 日發布 v2.4.0、11 月 18 日發布 v2.5.0 安全修復版本。
對習慣用 npm 或 Docker 自動拉取最新映像檔的團隊來說,這次版號規則切換與容器權限收斂非常關鍵。因為如果只依賴自動升級指令,套件管理器很可能會把新的 SemVer 視為「比舊日期版號更低」的版本而跳過更新,進而讓環境停留在含有已知漏洞的舊版。
本文將帶你釐清 MCP 官方伺服器這次從版號制度、non-root Docker 容器隔離到 v2.4.0/v2.5.0 漏洞修補的完整脈絡,並整理開發者升級時必須注意的實務操作細節。
為什麼 MCP 官方伺服器要從日期版號轉向 SemVer?
過去 modelcontextprotocol/servers 底下的部分 TypeScript 參考伺服器(例如 @modelcontextprotocol/server-filesystem)長期採用類似 2025.1.14 或 2026.8.31 的日期版號(CalVer)發布更新。日期版號雖然能讓使用者一眼看出軟體是在哪一天打包的,卻無法傳達 API 參數、工具回傳格式或環境需求是否出現破壞性變更(Breaking Changes)。在企業導入 CI/CD 自動化部署或鎖定套件相依性時,缺乏相容性語意的版號往往會讓整個代理工作流在無預警的情況下失效。
為了解決版本治理的混亂,維護團隊決定將 TypeScript 參考伺服器切換至業界標準的語意化版本(Semantic Versioning,簡稱 SemVer),也就是以「主版本.次版本.修訂號」(例如 2.3.0、2.3.1、2.4.0)來明確區分重大變動、功能擴充與安全修補層級。相對地,以 Python 開發的參考伺服器如 mcp-server-git 與 mcp-server-fetch 目前仍維持 2026.11.11 與 2026.11.18 這類日期格式,透過 PyPI 與 uvx 生態系發布,形成雙軌並行的過渡期。
這個切換帶來一個工程上必須特別留意的升級陷阱。由於在套件管理器的版本比較邏輯中,2026.8.31 的主版本數字遠大於 2.3.0 或 2.4.0,像 npm 這類工具在預設情況下會把新推出的 SemVer 判定為「比較舊的版本」。如果開發者只執行一般的 npm update 指令,或是依賴未鎖定標籤的自動更新腳本,系統往往不會自動替換掉既有的日期版號套件,導致環境表面上看起來已經執行過更新,實際上卻仍暴露在舊版風險之中。團隊必須明確指定版本標籤(例如執行 npm install @modelcontextprotocol/server-filesystem@2.4.0)才能順利完成遷移。

non-root Docker 安全機制解決了什麼容器風險?
在許多企業或開發者的測試架構裡,MCP 伺服器經常被打包成 Docker 容器,透過標準輸入輸出或網路通道讓 AI 代理呼叫工具。過去容器預設以最高權限的 root 身分執行程序,這在安全防護上留下了極大的隱患:一旦 AI 代理被網頁或文件中的惡意提示詞誘導,或是伺服器本身存在路徑穿越與指令注入漏洞,攻擊者就有機會以容器內 root 權限讀寫掛載目錄,甚至嘗試突破容器隔離,影響宿主機系統安全。
為了縮小潛在的攻擊半徑,官方團隊在儲存庫中合併了針對 Docker 映像檔的全面改造(fix(docker): run every server image as its non-root user),並在 v2.4.0 相關發布周期正式落地。所有官方參考伺服器容器,包含檔案系統(filesystem)、記憶體(memory)、綜合測試(everything)以及 Python 版的 fetch 與 git 伺服器,現在預設皆改以受限制的非特權帳號(例如 app 使用者)運行,徹底告別預設 root 的高風險設計。
這項改動在實務上意味著「最小權限原則」被直接寫進了預設映像檔之中。即便伺服器內部發生異常行為,程序也無法隨意修改系統級設定檔、安裝惡意套件或存取未授權的高權限資源。不過,對於既有的部署腳本而言,切換為 non-root 後如果容器需要讀寫本機掛載的資料夾,維運人員必須確認宿主機目錄的擁有者與讀寫權限(UID/GID)是否與容器內的非特權帳號相容,否則在啟動容器時很可能會遇到權限不足(Permission Denied)的錯誤。實務上建議搭配唯讀掛載(:ro)與精簡容器能力(如 --cap-drop=ALL),進一步壓縮容器遭濫用的空間。
延伸閱讀:GitHub Copilot App 新增瀏覽器操作與 Azure DevOps:預覽功能怎麼開、權限怎麼管?
v2.4.0 與 v2.5.0 修補了哪些高風險漏洞?
緊接在版號與容器權限調整之後,官方在 2026 年 11 月連續發布 v2.4.0 與 v2.5.0 兩個密集的安全修復版本,分別處理了六項與八項針對檔案系統、Git 操作、綜合測試套件與網頁抓取的嚴重漏洞。
| 套件名稱 | 受影響版本範圍 | 安全修復版本 | 主要修補風險類型 |
|---|---|---|---|
@modelcontextprotocol/server-filesystem |
早於 2.4.0 及 2025.1.14–2026.8.31 | 2.4.0 |
符號連結競態讀取、FIFO/裝置檔誤讀、move_file 越權移動 |
mcp-server-git |
截至 2026.11.11(含更早版本) | 2026.11.18 |
.git/config 惡意指令觸發、自動維護掛鉤執行、延遲抓取漏洞 |
@modelcontextprotocol/server-everything |
截至 2.3.0 | 2.3.1 |
參考實作安全補強與相依性更新 |
mcp-server-fetch |
截至 2026.11.4 | 2026.11.11 |
網頁抓取邊界安全修正 |
檔案系統伺服器的符號連結競態防禦
在 @modelcontextprotocol/server-filesystem 的 2.3.0 與 2.4.0 更新中,安全團隊重點解決了檢查與存取之間的時間差漏洞(TOCTOU)。過去系統在驗證路徑合法性後才開啟檔案,若攻擊者在檢查與讀取的極短瞬間將目錄置換為符號連結(symlink),就可能讓 AI 代理讀取到允許目錄以外的敏感資料(對應安全公告 GHSA-p9cv-8g75-4xcg)。新版在 Linux 與 macOS 上改為相對於已驗證目錄直接開啟檔案,同時拒絕讀取 FIFO 管線、socket 或特殊裝置檔,避免代理卡死或洩漏系統狀態;針對 move_file 工具,同裝置內的搬移也會先在已驗證目錄下重新命名,避免外部檔案被偷渡進授權目錄(GHSA-7m4x-rv66-mxhh)。官方也坦承在 Windows 平台上受限於系統架構,此舉僅能縮小競態窗口,尚未完全封堵該類風險。
Git 伺服器的設定檔與掛鉤隔離
mcp-server-git 在 2026.11.11 與 2026.11.18 兩次更新中,幾乎全面封鎖了透過惡意儲存庫觸發本地指令的路徑。過去當 AI 對不可信的外部專案執行看似無害、唯讀的 git_status 時,目標資料夾內的 .git/config 可能暗藏 core.fsmonitor、diff.external、簽章指令或過濾驅動程式,導致伺服器以自身權限執行外部程式(GHSA-6hqx-gqrx-c5r2)。此外,在 2026.11.18 中,團隊更進一步封堵了四項深層風險:第一,禁止所有 Git 指令觸發自動維護與垃圾回收掛鉤(設定 maintenance.auto=false 與 gc.auto=0,對應 GHSA-h2g3-rwxm-xfm3);第二,強制關閉延遲物件抓取(GIT_NO_LAZY_FETCH=1,對應 GHSA-87qg-cmw8-jc5m),避免偽造的遠端設定觸發 uploadpack 或 core.sshCommand;第三,在 git_checkout 與 git_merge 寫入工作樹後重新讀取驅動程式設定,防止衝突還原時夾帶惡意指令(GHSA-9vjp-x34c-xg6v);第四,針對 .gitattributes 中空名稱的過濾器 [filter ""] 一併納入清空範圍(GHSA-pm7p-vphh-2cg7)。若宿主機安裝的 Git 版本過舊(早於 2.31)無法支援這些安全覆寫參數,伺服器將直接拒絕執行。
開發團隊該如何安全使用官方參考伺服器?
儘管官方持續強化安全邊界,modelcontextprotocol/servers 在專案 README 開頭仍以醒目的警告標示提醒所有使用者:這個儲存庫定位為「參考實作」(Reference Implementations),目的是示範 MCP 協定與各語言 SDK 的用法,而非開箱即用的企業級生產解決方案。
這段官方聲明背後有兩層實務意義。第一,企業若要將檔案系統、Git 或網頁抓取能力導入真實工作流,不應只依賴預設配置,而應該評估自身的威脅模型,例如搭配容器網路隔離、限制僅能存取特定工作目錄、或在程式碼審查流程中避免直接對未經信任的第三方儲存庫啟用寫入類工具。第二,如果團隊確實基於官方套件進行開發或測試,務必建立版本監控清單,確認專案的 package.json 或容器映像檔中沒有遺留 2025.x 或 2026.8.x 的舊版日期套件,並將執行中的伺服器全面升級至 @modelcontextprotocol/server-filesystem@2.4.0、@modelcontextprotocol/server-everything@2.3.1 以及 mcp-server-git 2026.11.18 以上版本。
實務升級與容器部署檢核清單
為了避免在切換 SemVer 與 non-root Docker 的過程中導致既有 AI 代理工作流中斷,建議維運與開發團隊在部署前依序確認以下四個項目。首先,檢查所有本機與 CI 環境的依賴鎖定檔(如 package-lock.json 或 pnpm-lock.yaml),確認沒有因為日期版號大於語意化版號的比較陷阱,而讓工具停留在 2026.8.31 或更早的漏洞版本;必要時應先移除舊版快取後再重新指定目標 SemVer 標籤安裝。
其次,針對使用 Docker 掛載本機程式碼目錄的團隊,啟動新版 non-root 映像檔前,需先確認宿主機資料夾的存取權限與容器內非特權使用者相容;若只是讓 AI 代理進行程式碼審查或文件搜尋,強烈建議在掛載參數加上唯讀旗標,從作業系統層級阻斷任何未預期的寫入或搬移操作。第三,檢查宿主機或基礎映像檔中的 Git 版本是否達到 2.31 以上,否則新版 mcp-server-git 為了防堵 .git/config 惡意覆寫漏洞,會直接拒絕在不支援安全參數的舊版 Git 環境中啟動。最後,若企業同時使用多個社群或第三方 MCP 伺服器,應透過官方的 MCP 註冊表(MCP Registry)盤點來源可信度,並為每一個工具伺服器設定獨立的環境變數白名單,避免將雲端 API 金鑰或雲端憑證直接暴露在同一個容器程序之中,才能真正發揮最小權限隔離的防護價值。
延伸閱讀:LangSmith 新增程式代理 ROI 儀表板:每份已合併 PR 花多少,如何對回成果?
常見問題(FAQ)
為什麼用 npm update 無法升級到 @modelcontextprotocol/server-filesystem 2.4.0?
因為該套件先前使用的是 2025.1.14 至 2026.8.31 這類日期版號,主版本號數字遠大於 SemVer 的 2.4.0。套件管理器會判定數字較小的版本為舊版,因此必須手動執行指定標籤的安裝指令(如 npm install @modelcontextprotocol/server-filesystem@2.4.0)來強制切換。
改成 non-root Docker 執行後,舊的掛載指令會壞掉嗎?
如果容器只是讀取公開權限的目錄通常能正常運作,但若需要寫入宿主機掛載的資料夾,且該資料夾僅開放給 root 寫入,non-root 使用者就會遇到權限拒絕。建議在部署前檢查宿主機掛載路徑的讀寫權限設定,或透過容器啟動參數對應適當的 UID。
MCP 官方參考伺服器可以直接部署到公司正式環境嗎?
官方在文件明確指出,這些伺服器是作為教學與示範用途的參考實作,並非專為高強度生產環境打造。若要用於正式業務,開發團隊需依據自身安全需求額外加上身分驗證、稽核紀錄與資源隔離機制,並持續追蹤安全公告。
Python 版的 mcp-server-git 也改用 SemVer 了嗎?
目前還沒有。根據 v2.4.0 與 v2.5.0 的發布對照表,Python 實作的 mcp-server-git 與 mcp-server-fetch 仍維持 2026.11.11、2026.11.18 這類日期版號,只有 TypeScript 系列的參考伺服器完成 SemVer 轉換。建議使用 uvx 或 pip 管理的團隊持續追蹤 Python 套件的發布標籤,並在相依設定檔中鎖定安全修復後的明確日期版號,以免在自動化建置時拉取到未修補漏洞的舊版映像。
總結
modelcontextprotocol/servers 從版號制度切換到 SemVer、Docker 映像檔全面導入 non-root 帳號,再到 v2.4.0 與 v2.5.0 連續封堵檔案競態與 Git 設定檔漏洞,清楚顯示 MCP 生態系正在從早期的實驗展示階段,加速走向重視安全邊界與可維護性的工程化階段。
對於正在導入 AI 代理與工具串接的團隊而言,這次連續更新傳遞了一個明確訊號:連接本地資源的便利性必須建立在嚴格的權限隔離與版本治理之上。現在正是盤點既有 MCP 套件版號與容器權限的最佳時機,確認所有環境都已脫離受影響的舊版日期版號與特權容器設定,並建立定期檢視安全公告與依賴更新的例行作業,才能確保工具鏈在賦予模型強大行動力的同時,也能真正守住企業系統安全的底線。