安裝
npx -y @modelcontextprotocol/server-puppeteer適合誰
適合需要讓模型在本機真實瀏覽器裡開啟網頁、看主控台或留下截圖的人。證據寫明:這是用 Puppeteer 做瀏覽器自動化的 MCP 伺服器,模型可以與頁面互動、截圖,並在真實瀏覽器環境裡執行 JavaScript。
它跑在你的機器上,因此也能碰到本機檔案和本機/內網 IP。只有在你接受這條隱私邊界、並且能看住敏感資料時,才應接入。證據沒有列出用戶端名單,只涵蓋到:你已有可設定 MCP 的用戶端,並能執行 npx。
官方頁面位於 servers-archived 目錄樹。證據沒有另寫維護狀態或替代實作,因此不要把它當成一定仍在更新的現行產品。
3 分鐘完成第一次嘗試
走證據給出的 NPX 路徑,在用戶端 MCP 設定裡使用:
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-puppeteer"]
不要同時把 Docker 當主路徑。證據只補充:Docker 會用無頭 Chromium,NPX 會跳出瀏覽器視窗。
前置條件:本機裝有 Node/npx;第一次只開啟你有權造訪、且不會提交表單或登入的公開頁。啟動後會在本機跑瀏覽器,可能存取本機檔案與內網位址。
設定位置:用戶端的 MCP 伺服器設定(stdio 命令與參數)。儲存後重啟或重載用戶端。
低風險第一次呼叫:只呼叫證據完整寫出的 puppeteer_navigate,導覽到上一句所說的 URL。證據沒有給出該工具的參數欄位;collect 摘要還提到 screenshot、click、hover、fill、select、evaluate,但對應 locator 沒有展開,第一次不要呼叫它們。
成功訊號:NPX 路徑下應看到本機瀏覽器視窗開啟,並停留在你給出的位址。隨後可讀取資源 console://logs(文字主控台輸出)或 screenshot://<name>(PNG)。若視窗沒出現,先確認你走的是 NPX 而不是 Docker。
使用案例
案例 1:讓模型開啟一個指定公開頁。呼叫 puppeteer_navigate。證據只保證「在瀏覽器中導覽到任意 URL」,沒有寫逾時、重新導向或是否帶上本機 cookie。因此能確認的是:導覽發生在本機真實瀏覽器裡;不要假設這是隔離的雲端工作階段。
案例 2:開啟頁面後核對主控台或留下截圖。第一條證據寫明可以截圖並執行 JavaScript;資源證據給出 console://logs(包含瀏覽器全部主控台訊息)和 screenshot://<name>(已擷取截圖的 PNG)。證據沒有寫截圖工具名、<name> 如何產生,也沒有寫出 evaluate 的參數。因此第二次只讀這些資源,或停在「證據只保證能截圖/執行 JS」這一層,不要編造選擇器或指令碼。
使用邊界
本機瀏覽器可以存取本機檔案和本機/內網 IP,可能帶出敏感資料。NPX 會開啟可見視窗,Docker 則是無頭 Chromium,兩者行為不同,不要混用後再用視窗當成功訊號。證據完整點名的工具只有 puppeteer_navigate;互動類能力(點擊、填寫)沒有帶參數的 locator,執行它們有頁面副作用。資源僅列出主控台與截圖,沒有撤銷、清理 cookie 或關閉瀏覽器的步驟。證據沒有寫用戶端名單、權限模型或封存後的替代套件。