browser-tools-mcp
直接從 Cursor 及其他相容 MCP 的 IDE 監控瀏覽器日誌。
browser-tools-mcp 是什麼?
直接從 Cursor 及其他相容 MCP 的 IDE 監控瀏覽器日誌。
browser-tools-mcp 概覽
這是什麼
BrowserTools MCP 是一個讓 AI 編碼代理能夠存取瀏覽器資料的工具。它將主控台輸出、網路活動、螢幕截圖和 Lighthouse 稽核結果,從真實的 Chrome 工作階段串流到任何相容 MCP 的客戶端,例如 Cursor、Claude Code、Windsurf、Cline、Zed 和 Gemini CLI。2.0 版本經過重寫,以單一程序執行,移除了未經認證的本機伺服器,在資料離開瀏覽器前清除憑證,並包含測試套件。
主要功能
- 從使用者實際的 Chrome 工作階段串流主控台日誌、網路請求、螢幕截圖和 Lighthouse 稽核(效能、無障礙、SEO、最佳實踐)。
- 透過 DevTools 擴充功能附加到瀏覽器,使用者保持登入狀態並停留在同一頁面。
- 提供超過 20 個工具,包括
getConsoleLogs、getNetworkLogs、takeScreenshot、runAccessibilityAudit、runPerformanceAudit等。 - 將大量資料以 MCP 資源(主控台、網路、HAR、螢幕截圖、稽核報告)的形式暴露,以保持上下文視窗的可管理性。
- 內建三個提示(
debuggerMode、auditMode、nextjsSeoAudit)來引導代理的工作流程。 - 支援同時處理多個分頁,遙測資料按分頁歸屬,工具預設作用於當前分頁。
使用情境
- 偵錯使用者當前正在檢視的應用程式,無需在單獨的瀏覽器設定檔中重新建立驗證狀態。
- 直接從 IDE 執行 Lighthouse 效能、無障礙、SEO 和最佳實踐稽核。
- 在開發過程中即時監控主控台錯誤和網路失敗。
快速開始
- 在 MCP 客戶端中加入伺服器設定:
{
"mcpServers": {
"browser-tools": {
"command": "npx",
"args": ["-y", "@agentdeskai/browser-tools-mcp@latest"]
}
}
}
在 Windows 上,使用 "command": "cmd" 搭配 "args": ["/c", "npx", "-y", "@agentdeskai/browser-tools-mcp@latest"]。需要 Node 22.19 或更新版本。
-
載入 Chrome 擴充功能:開啟
chrome://extensions,啟用開發人員模式,選擇「載入未封裝項目」,然後選取已複製儲存庫中的chrome-extension目錄。 -
在要檢查的頁面上開啟 Chrome DevTools(F12)。擷取會自動開始。若要驗證設定,請執行
npx @agentdeskai/browser-tools-mcp --doctor。
授權與價格
採用 MIT 授權。開放原始碼且免費使用。
內容整理自該專案公開的 README 與儲存庫資訊。