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 中安裝:

Install in VS Code Install in VS Code Insiders

或者,透過 VS Code CLI 安裝:

code --add-mcp '{"name":"kogiqa-browser","command":"npx","args":["kogiqa-mcp@latest"]}'

Cursor

Install in Cursor

或者,前往 Cursor SettingsMCPAdd 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 用戶端