kogiQA MCP Web Browser
官方這是一個網頁瀏覽器,能讓您的編碼代理(例如 Claude Code)代您訪問網站,並協助您識別錯誤或建立 UI 測試案例。
你可以用 kogiQA Web Browser MCP 做什麼?
請讓您的助理透過自然語言驅動真實瀏覽器——無需選擇器。
- 除錯樣式問題 — 讓助理檢查頁面並解釋元素為何溢出或錯位,然後建議 CSS 修正。
- 修正主控台錯誤 — 要求助理瀏覽各頁面、收集主控台錯誤,並在您的原始碼中套用修正。
- 繪製並記錄您的應用程式 — 指示助理探索內部連結,並為每個頁面的功能產生 Markdown 概覽。
- 產生端對端測試 — 要求 Cypress 測試涵蓋流程的快樂路徑與驗證錯誤。
- 執行探索性測試 — 讓助理在表單中嘗試邊緣案例輸入,並回報損壞或不一致的行為。
文件
kogiQA MCP Web Browser
一個使用 kogiQA 提供瀏覽器自動化功能的 Model Context Protocol (MCP) 伺服器。此伺服器讓 LLM 能透過自然語言與網頁互動,無需截圖或視覺調校模型。
用途:
- 偵錯頁面上的樣式問題
- 自動修復 console 錯誤。
- 繪製並記錄您的 Web 應用程式功能
- 自動撰寫端對端測試
- 自動化應用程式的探索性測試
請參閱範例提示詞 使用範例
kogiQA MCP 與 Playwright MCP 的比較
kogiQA MCP 伺服器提供一個整合了 kogiQA 瀏覽器控制演算法能力的瀏覽器。這讓代理程式無需選擇器即可與頁面互動,節省時間與 token。
安裝
自動安裝:
npx kogiqa-mcp@latest
Claude Code
claude mcp add kogiqa-browser npx kogiqa-mcp@latest
VS Code
按一下下方任一按鈕,即可直接在 VS Code 中安裝:
或者,透過 VS Code CLI 安裝:
code --add-mcp '{"name":"kogiqa-browser","command":"npx","args":["kogiqa-mcp@latest"]}'
Cursor
或者,前往 Cursor Settings → MCP → Add new MCP Server,然後輸入指令 npx kogiqa-mcp@latest。
標準設定
對於任何其他 MCP 用戶端,請將以下內容新增至您的 MCP 設定:
{
"mcpServers": {
"kogiqa-browser": {
"command": "npx",
"args": [
"kogiqa-mcp@latest"
]
}
}
}
使用範例
伺服器設定完成後,只需以自然語言與您的代理程式交談即可。由於 kogiQA 無需選擇器,您只需描述想要完成的事,而非如何尋找元素。
冒煙測試使用者流程
Open http://localhost:3000, log in with the demo credentials, add the first product to the cart, and verify that the cart badge shows "1".
偵錯樣式問題
Go to https://myapp.example.com/pricing and check why the "Pro" plan card overflows its container on a 1280px-wide viewport. Suggest a CSS fix.
修復 console 錯誤
Navigate to http://localhost:5173, open every page linked from the main menu, collect all console errors, and fix them in the source code.
繪製並記錄您的應用程式
Explore https://staging.example.com, follow all internal links up to two levels deep, and produce a Markdown document describing each page and its main features.
產生端對端測試
Walk through the sign-up flow at http://localhost:3000/signup and write Cypress end-to-end tests covering the happy path and validation errors.
探索性測試
Do 10 minutes of exploratory testing on http://localhost:8080: try edge-case inputs in every form you find and report anything that looks broken or inconsistent.
系統需求
- Node.js 20 或更新版本
- VS Code、Cursor、Windsurf、Claude Desktop、Goose、Junie 或其他 MCP 用戶端