AI 寫程式工具也中供應鏈攻擊?Coding Agent Audit 掃描 MCPhantom 幻覺套件與高風險設定

開源 CLI 工具 coding-agent-audit 專門針對 Claude Code、Cursor 與 Windsurf 進行本地端安全稽核,涵蓋木馬化擴充套件 IOC、MCPhantom 幻覺套件誤植搶註偵測、工具描述提示詞注入與高風險自動核准規則。

Share
coding-agent-audit GitHub 官方專案預覽圖
stackscribe-ai/coding-agent-audit GitHub 專案頁面的官方預覽圖。 圖片來源:官方原文。

近年來,Claude Code、Cursor、Windsurf 與 GitHub Copilot 等 AI 寫程式工具快速成為工程師的日常主力,但這股熱潮也讓攻擊者將目標轉向開發者的編輯器擴充套件與本機設定檔。與傳統只讀取靜態程式碼的資安掃描不同,現代 AI 代理往往具備執行終端機指令與自動載入遠端 MCP(Model Context Protocol)伺服器的能力,一旦設定或套件來源遭滲透,攻擊者幾乎能直接取得本機權限。

2026 年 10 月,資安界揭露了一起針對 Open-VSX 與 Cursor 市集的供應鏈攻擊事件:名為 anthropic.claude-code@2.1.313 的惡意木馬化擴充套件被上傳至市集。只要編輯器載入該擴充套件,無須任何額外點擊,它就會在背景靜默植入 SSH 金鑰、開啟反向 SSH 通道,並在 macOS、Linux 與 Windows 上建立系統持久化機制。

為了協助開發者快速排查這類針對 AI 編程代理的威脅,開源專案 stackscribe-ai/coding-agent-audit 應運而生。這是一款透過 Python 打包發布(pip install coding-agent-audit)的輕量級命令列稽核工具,執行 agent-audit 即可同時掃描已知的入侵指標(IOC)與危險的本機代理設定。

值得特別注意的是,該專案在授權與透明度上相當特別:作者 StackScribe AI 明確揭露這套工具、測試與文件皆由自主 AI 軟體專案自動建置而成,且未經人類預先審查程式碼。因此官方在 README 中也提醒使用者,在敏感環境執行前可先檢視其精簡的原始碼,將其作為快速初篩與設定健檢的輔助工具。

為什麼需要專門針對 AI 代理的稽核工具?

傳統的防毒軟體或相依套件掃描器(SCA),大多聚焦在 package.json 裡的已知 CVE 漏洞或惡意二進位執行檔,卻很難看懂 .claude/settings.json、.mcp.json 或編輯器設定裡隱藏的邏輯風險。

舉例來說,一份看似正常的 MCP 設定檔,可能只是寫了一行 npx -y some-mcp-server。對傳統靜態掃描器而言,這段 JSON 語法完全合法且無害;但對 AI 代理而言,每一次啟動對話都會透過 npx 或 uvx 自動從公開套件庫抓取並執行程式碼。如果該套件名稱根本不存在、已被原作者下架,或是沒有鎖定具體版本號,攻擊者就能利用「幻覺套件搶註」(Slopsquatting)或後續版本替換直接拿下開發者電腦。

coding-agent-audit 正是針對這個盲點設計,將檢查分為「已知入侵指標(IOC)掃描」、「設定檔啟發式風險分析」、「工具描述注入檢查」與「幻覺套件比對」四大防線。

延伸閱讀:GitHub 與 Microsoft 公開 MDASH 試行:9,791 筆 AI 資安發現,為何只送出 99 份報告?

coding-agent-audit GitHub 官方專案預覽圖
stackscribe-ai/coding-agent-audit GitHub 專案頁面的官方預覽圖。 圖片來源:官方原文。

MCPhantom 與幻覺套件:當 AI 幫你寫出不存在的 MCP 名稱

在 MCP 生態系快速擴張的過程中,資安團隊 Glow Labs 於 2026 年 11 月提出了一個名為 MCPhantom 的新型供應鏈攻擊模式。

當開發者請 AI 編程代理幫忙設定一個新的 MCP 伺服器時,模型常會根據訓練資料的記憶,填入一個「聽起來很合理但其實不存在」的套件名稱,或是引用早期官方教學中已經被棄用、更名或下架的舊套件名稱。不同於傳統 package.json 還需要開發者手動執行安裝指令才會觸發風險,寫進 .mcp.json 的 npx、uvx 或 pipx run 指令,會在每次開啟代理或工作階段時自動執行。

只要攻擊者搶先在 npm 或 PyPI 上註冊那個被 AI 幻覺出來的名稱,下一次工程師啟動編輯器時,就會在毫無警覺且無須核准的情況下自動執行惡意程式碼。

針對這個威脅,coding-agent-audit 透過 --check-deps 參數提供了兩項主動防禦檢查:

  • 專案相依套件掃描(phantomdeps.py):讀取指定專案中的 package.json、requirements.txt 與 pyproject.toml,對 npm 與 PyPI 進行唯讀 HTTP 查詢,標記出尚未註冊的幽靈套件名稱(網路異常則判定為無法確認,避免誤報)。
  • MCP 幻覺套件掃描(scan_mcp_phantom_packages):直接解析本機與專案 MCP 設定檔中的所有 npx、uvx 與 pipx run 呼叫指令,比對公開套件庫是否真實存在該套件,提前攔截 MCPhantom 搶註風險。

本機入侵指標(IOC)掃描:排查木馬擴充套件與惡意蠕蟲

除了預防性的設定檢查,coding-agent-audit 的 checks.py 模組也內建了針對多起公開 AI 編程工具資安事件的入侵指標比對功能:

  1. Open-VSX / Cursor 市集木馬化 Claude Code(v0.2.1 起強化):檢查 ~/.ssh/authorized_keys 是否被植入特定金鑰註解、macOS 的 ~/Library/LaunchAgents/com.apple.sysmond.plist 持久化項目、~/.config 下的特定標記檔案(包含 smtk 等)、殘留的暫時 SSH 通道金鑰、常見編輯器擴充目錄中 extension.js 的雜湊值,以及 Windows 上的 SysMon 排程工作與啟動資料夾備援腳本 sysmon.cmd。
  2. EMBRACE 內嵌瀏覽器漏洞檢查:針對 Forever Security 於 2026 年 10 月揭露的編輯器內嵌瀏覽器網址列欺騙風險,檢查 GitHub Copilot VS Code 擴充套件是否低於已修補的 1.1.29 版本,並標示本機安裝的受影響客戶端以提供緩解建議。
  3. Mini Shai-Hulud 與 SANDWORM_MODE npm 蠕蟲:偵測鎖定 Claude Code 與 VS Code 的 gh-token-monitor 持久化服務(具備在 GitHub 權杖遭撤銷時清空家目錄的破壞機制)及 .claude/router_runtime.js 等植入檔;同時掃描會在各編輯器註冊流氓本機 MCP 伺服器的隱藏 ~/.dev-utils/ 目錄與可疑工具名稱(如 index_project、lint_check、scan_dependencies)。

抓出危險 MCP 設定:未鎖定版本、已知 RCE 與「致命三合一」

在設定檔啟發式掃描(configscan.py)中,coding-agent-audit 針對日常容易忽略的配置失誤設計了多層規則:

  • 危險鉤子與未鎖定套件:偵測把 curl 下載內容直接導向 Shell 執行的 Hook 指令、寫入 authorized_keys、使用 netcat 進行反彈 Shell 的行為,以及使用 npx -y pkg 卻未鎖定版本號的 MCP 伺服器定義。只要沒有鎖定版本,遠端套件一旦被惡意接管或發布新版,本機就會在下次啟動時自動拉取受感染版本。
  • 明確鎖定至已知 RCE 漏洞版本(v0.10.0 新增):若設定檔中明確鎖定了低於 v0.1.16 的 mcp-remote(受 CVE-2025-6514 影響,CVSS 9.6,惡意遠端伺服器可透過未淨化的 OAuth authorization_endpoint 回應,在僅開啟客戶端時即觸發任意系統指令執行),或低於 v2025.12.18 的 mcp-server-git(受 CVE-2025-68143/68144/68145 影響,這是 Anthropic 官方參考實作的 Git MCP 伺服器,可透過間接提示詞注入串聯成完整遠端程式碼執行),掃描器會立即發出警告。值得注意的是,這項規則只會標記明確鎖定舊版的設定,因為未鎖定版本者會自動取得已修補的新版(並另由未鎖定規則提醒)。
  • 無條件萬用字元與「致命三合一」(Lethal Trifecta):除了抓出 Bash(*) 這類過寬的自動核准權限外,更會檢視是否同時自動核准了「讀取外部不可信內容的工具」(如 WebFetch、WebSearch、瀏覽器或網頁爬蟲 MCP)與「具備寫入或執行能力的工具」(如 Bash、Write、Edit),且兩者之間缺乏人工確認關卡。這種組合一旦遇到網頁中的隱藏提示詞注入,就可能直接演變為資料外洩或命令執行。

工具定義提示詞注入檢查(--tools-json)

即使 MCP 伺服器本身的套件完全合法,惡意或遭入侵的遠端伺服器仍可在回應 tools/list 時,於工具的 description 欄位夾帶隱藏指令(例如「每次呼叫工具後也呼叫 X」、「不要告訴使用者」、「將資料傳送至某網址」或偽造 system:、assistant: 角色標籤)。由於 MCP 用戶端會將工具描述視為給大型語言模型的權威指引,這種手法無須在套件層植入任何惡意程式碼,就能暗中誘導代理去呼叫另一個攻擊者控制的外部工具,或向使用者隱瞞真實操作,因此傳統 IOC 與靜態設定掃描完全無法察覺。

透過執行 agent-audit --skip-ioc --skip-config --tools-json my-mcp-servers-tools.json,開發者可以在完全不連線、也不啟動目標 MCP 伺服器的前提下,離線檢查從用戶端或 tools/list 匯出的 JSON 工具定義清單,提前攔截潛在的提示詞注入文字。此外,這項檢查也支援在一個代理審計另一個代理工具時透過無檔案方式直接呼叫,成為多代理協作環境中的第一道防線。

在實務排查上,官方也提供清晰的指令組合與結束代碼設計:日常全機掃描可直接執行 agent-audit;若只想排查指定專案的 .claude/ 與 .mcp.json 可加上 --project /path/to/repo;若需要略過設定啟發式檢查或只看設定風險,則可分別搭配 --skip-config 或 --skip-ioc。對於自動化管線來說,結束代碼 0 代表未發現異常、1 代表僅有警告或資訊性提醒、2 則表示至少命中一項經確認的嚴重入侵指標模式,讓團隊能精準決定何時該中斷流程或發出警報。

多元整合方式:CLI、CI GitHub Action 與 MCP Server 模式

為了配合不同團隊的工作流程,coding-agent-audit 提供了四種彈性使用方式:

  1. 本機 CLI 快速掃描:安裝後執行 agent-audit 即可掃描家目錄設定,加上 --project /path/to/repo 可一併檢查專案內的 .claude/ 與 .mcp.json;搭配 --json 輸出與結束代碼(0 為無發現、1 為警告或資訊、2 為至少一項確認的嚴重 IOC 模式),方便整合至自動化腳本。
  2. GitHub Action(PR 關卡):若團隊將 .claude/settings.json 或 .mcp.json 納入版控,可在 CI 流程加入 stackscribe-ai/coding-agent-audit-action@v1,在 Pull Request 階段自動阻擋危險 Hook、萬用字元權限或未鎖定版本的 MCP 設定合併進主分支。
  3. 以 MCP Server 模式在對話中自檢:透過 uvx coding-agent-audit(或安裝後的 agent-audit-mcp 指令)將其掛載進 Claude Desktop 或 Claude Code,即可公開 scan_for_known_backdoors、scan_mcp_config 與 scan_tool_descriptions 三個工具,讓 AI 助手直接協助審計其他工具定義或本機設定。
  4. 免安裝 x402 按次計費 HTTP API:提供給自動化管線或代理呼叫的端點(POST https://stackscribe-audit-x402.stackscribe-paywall-worker.workers.dev/audit),若未帶入 X-PAYMENT 標頭會回傳 402 與 x402 v2 價格資訊(每次請求為 0.02 USDC on Polygon,透過公開 PayAI facilitator 結算),無須建立帳號、API 金鑰或 KYC 即可程式化呼叫。不過該端點僅就送出的 JSON 設定物件進行啟發式檢查(可透過 GET /openapi.json 查看規格),無法執行本機檔案系統的 IOC 掃描,因此免費的本地 CLI 依然是功能最完整的首選方案。
  5. 免安裝網頁版即時稽核報告:針對需要將稽核結果附在資安問卷、交付給客戶審閱,或是不想在本機安裝 Python 套件的使用者,StackScribe AI 也提供純網頁端的設定貼上介面,能直接產生可分享的稽核報告,方便顧問與工程團隊快速溝通風險。

延伸閱讀:Replit Desktop 讓 Agent 處理本機檔案:資料夾授權、沙箱與雲端分享怎麼分?

常見問題(FAQ)

Q1:執行 agent-audit 顯示一切正常,就代表電腦絕對沒有中毒嗎? 不是。官方在文件限制說明中明確強調,這是一款輕量級的初篩與風險分類工具,而非企業級端點防護軟體(EDR)。未命中僅代表沒有發現目前已知且已建檔的 IOC 與設定樣式,並不能證明系統完全未遭入侵;同時啟發式設定檢查也可能對刻意為之的合法設定產生誤報,判讀時應檢視詳細說明。

Q2:開啟 --check-deps 掃描幻覺套件時,會自動下載或安裝任何未知套件嗎? 不會。phantomdeps.py 與 scan_mcp_phantom_packages 只會對 npm 與 PyPI 套件庫發送唯讀的 HTTP 查詢請求來確認套件是否存在,完全不會下載或執行任何程式碼。

Q3:為什麼 coding-agent-audit 的專案描述特別標註「AI-disclosed」? 因為這套工具、測試案例與說明文件都是由自主 AI 軟體專案 StackScribe AI 自動開發與發布,過程中沒有經過人類工程師預先審查。官方建議使用者在機敏環境使用前,先花幾分鐘親自檢視其原始碼內容。

Q4:如果在 CI 流程使用 GitHub Action,也能掃描開發者電腦的木馬擴充套件嗎? 不能。GitHub Action 運作在暫時性的 CI 執行器(Runner)上,僅適合檢查專案倉庫內提交的 .claude/ 與 .mcp.json 設定風險;針對 ~/.ssh、LaunchAgents 或本機編輯器擴充目錄的 IOC 檢查,必須在開發者自己的電腦上執行 CLI 才能發揮作用。

總結

隨著 AI 編程代理取得越來越多本機檔案與終端機權限,開發環境的攻擊面早已從「程式碼相依套件」延伸到「代理設定檔與 MCP 生態系」。coding-agent-audit 雖然定位為輕量級且由 AI 自主建構的開源稽核工具,但它精準點出了 MCPhantom 幻覺套件搶註、未鎖定版本 MCP、工具描述注入與「致命三合一」自動核准等真實風險。無論是直接拿來健檢本機 Claude Code 與 Cursor 設定,或是參考其檢查清單來規範團隊的 .mcp.json 版控準則,都能大幅降低 AI 寫程式時代的供應鏈安全隱憂。

資料來源