适合谁
- Web开发人员调试和测试复杂Web应用
- QA工程师自动化端到端测试
- 需要无需选择器浏览器交互的AI代理
K
38FMRS · D
kogiQA MCP Web Browser 是一个实用的浏览器自动化服务器，通过自然语言和无需选择器的方式，为AI代理提供高效的网页交互能力。它特别适合开发和测试场景，但需要注意运行环境和安全风险。
kogiQA MCP Web Browser 是一个基于 Model Context Protocol (MCP) 的服务器，利用 kogiQA 浏览器控制算法提供浏览器自动化能力。它允许大语言模型通过自然语言与网页交互，无需截图或视觉模型，也无需CSS选择器，节省时间和令牌。适用于调试样式问题、自动修复控制台错误、映射和记录Web应用功能、自动编写端到端测试以及自动化探索性测试。
工具能力
browser_navigate
导航到指定URL。
browser_act
在页面上执行操作（如点击、输入、悬停等）。
browser_extract
从页面提取结构化数据或文本。
browser_evaluate
在页面上下文中执行JavaScript代码。
browser_console
获取或清除浏览器控制台日志。
browser_screenshot
截取当前页面截图（用于视觉调试）。
安装接入
- 确保已安装Node.js 20或更高版本。
- 在支持MCP的客户端（如Claude Desktop、VS Code、Cursor等）中，使用npx命令添加服务器：
npx kogiqa-mcp@latest。 - 对于VS Code，可通过按钮或CLI命令安装；对于Cursor，可在设置中添加MCP服务器并输入上述命令。
- 对于其他客户端，将提供的JSON配置添加到MCP设置中。
claude_desktop_config.json
{
"mcpServers": {
"kogiqa-browser": {
"command": "npx",
"args": [
"kogiqa-mcp@latest"
]
}
}
}
选型与风险
不适合谁
- 需要高精度视觉验证的任务（如图像识别）
- 需要绕过浏览器安全限制的任务
- 在无Node.js 20+环境下的部署
所需权限
- 需要Node.js运行环境
- 需要网络访问以导航网页
- 可能需要对本地开发服务器的访问
- 需要执行JavaScript代码的能力
风险与副作用
- 可能执行未经验证的导航或操作，导致意外行为
- 可能暴露敏感信息（如控制台日志）
- 需要信任的第三方服务（kogiQA）
- 可能引发安全风险若浏览器自动化被滥用
常见排障
- 检查Node.js版本是否满足20或更高
- 确认MCP客户端配置正确，命令为'npx kogiqa-mcp@latest'
- 检查网络连接，确保能访问目标网页
- 查看客户端日志以获取错误信息
- 确保目标应用运行在可达的地址上
使用场景
对用户流程进行冒烟测试：打开本地应用，登录，添加商品，验证购物车徽章。
调试样式问题：检查特定页面元素在特定视口下的溢出问题，并建议CSS修复。
修复控制台错误：遍历所有页面，收集控制台错误，并在源码中修复。
映射和文档化应用：探索站内链接，生成每个页面及其主要功能的Markdown文档。
生成端到端测试：为注册流程编写Cypress测试，覆盖正常路径和验证错误。
探索性测试：对应用进行10分钟探索性测试，尝试表单中的边缘输入并报告问题。
支持客户端
Claude Desktop完整支持
VS Code完整支持
Cursor完整支持