kogiQA MCP Web Browser

官方

这是一个网页浏览器，能让您的编码助手（如Claude Code）代您访问网站，并协助您识别错误或创建UI测试用例。

GitHub
144

你可以用 Kogi QA Web Browser MCP 做什么？

  • 调试样式问题 — 让代理在特定视口宽度下检查页面，识别布局问题，并建议 CSS 修复方案。
  • 自动修复控制台错误 — 让代理遍历菜单中链接的所有页面，收集控制台错误，并在源代码中应用修复。
  • 映射并记录 Web 应用功能 — 指示代理按设定深度爬取内部链接，生成一份 Markdown 文档，描述每个页面及其功能。
  • 生成端到端测试 — 描述一个用户流程（例如注册），让代理执行该流程，并输出覆盖正常路径和验证错误的 Cypress 测试。
  • 执行探索性测试 — 请求在限定时间内对每个表单进行探索性测试，使用边界输入，并生成一份报告，列出所有异常或不一致之处。

文档

kogiQA MCP Web Browser

一个模型上下文协议（MCP）服务器，利用 kogiQA 提供浏览器自动化能力。该服务器使大语言模型能够通过自然语言与网页交互，无需截图或视觉调优模型。

适用场景：

  • 调试页面上的样式问题
  • 自动修复控制台错误
  • 映射并记录 Web 应用的功能
  • 自动编写端到端测试
  • 自动化应用的探索性测试

请参阅示例提示 使用示例

kogiQA MCP 与 Playwright MCP 对比

kogiQA MCP 服务器提供了一个集成了 kogiQA 浏览器控制算法的浏览器。这使得智能体无需选择器即可与页面交互，从而节省时间和令牌。

安装

自动安装：

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 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.

修复控制台错误

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 客户端