← 返回目录

kogiQA MCP

社区

为AI代理设计的无选择器Web浏览器自动化MCP服务器，专注调试与测试。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 浏览器自动化第 29 / 32
Stars: ★ 95 热门
传输方式: stdio（本地进程）
运行环境: Node.js 20+
凭据: 无需凭据
许可证: MIT
最近提交: 6 天前
工具数: 6

38FMRS · D

kogiQA MCP Web Browser 是一个实用的浏览器自动化服务器，通过自然语言和无需选择器的方式，为AI代理提供高效的网页交互能力。它特别适合开发和测试场景，但需要注意运行环境和安全风险。

最强项 · 安装易用性 12/20 最弱项 · 可靠性 5/20

可靠性

5/20

安全与权限

5/20

维护活跃度

8/20

文档质量

8/20

安装易用性

12/20

查看各项评分依据

可靠性 5/20: README 与 manifest 描述了基于 npm 的 stdio 服务器，正常路径看似可行；但未提供源码、工具清单、测试或 CI 配置，无法验证 MCP 握手、工具声明与错误处理，故扣除大部分可靠性分。
安全与权限 5/20: 提供的材料中没有凭据、环境变量或数据流披露。该服务器控制浏览器并可能访问任意 URL 和执行页面操作，副作用与网络边界不明确。未发现恶意或红线证据，但由于权限、确认和数据披露缺失而扣分。
维护活跃度 8/20: 仓库声明 MIT 许可、未归档，且 npm 上存在 1.3.40 版本；但未提供提交频率、依赖更新或问题响应记录。星数仅作为发现信号，不能加分。因缺乏持续维护证据而扣分。
文档质量 8/20: README 包含 npx 安装、Claude Code/VS Code/Cursor 的配置、标准 JSON 配置、环境要求及使用示例；但缺少工具/参数文档、故障排除、限制说明以及权限和数据披露，故扣分。
安装易用性 12/20: 安装只需 npx 命令和复制客户端配置，且明确要求 Node.js 20，覆盖多个主流客户端。但未提供执行证据（CI 或已提交测试），也未说明浏览器运行依赖或平台限制，故按保守原则低于 15 上限给分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络控制浏览器

适合谁

Web开发人员调试和测试复杂Web应用
QA工程师自动化端到端测试
需要无需选择器浏览器交互的AI代理

不适合谁

需要高精度视觉验证的任务（如图像识别）
需要绕过浏览器安全限制的任务
在无Node.js 20+环境下的部署

所需权限

需要Node.js运行环境
需要网络访问以导航网页
可能需要对本地开发服务器的访问
需要执行JavaScript代码的能力

风险与副作用

可能执行未经验证的导航或操作，导致意外行为
可能暴露敏感信息（如控制台日志）
需要信任的第三方服务（kogiQA）
可能引发安全风险若浏览器自动化被滥用

安装接入

准备工作

运行环境：Node.js 20+

确保已安装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"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "kogiqa-browser": {
      "command": "npx",
      "args": [
        "kogiqa-mcp@latest"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add kogiqa-browser -- npx kogiqa-mcp@latest

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 MCP 客户端中配置 npx kogiqa-mcp@latest 后，检查工具列表中是否出现 browser_navigate、browser_act、browser_extract、browser_evaluate、browser_console、browser_screenshot 这些工具，或直接输入提示让浏览器导航到一个页面并截图验证。

常见排障

检查Node.js版本是否满足20或更高
确认MCP客户端配置正确，命令为'npx kogiqa-mcp@latest'
检查网络连接，确保能访问目标网页
查看客户端日志以获取错误信息
确保目标应用运行在可达的地址上

试试这样问

连接成功后，可以直接对 AI 助手这样说：

打开 http://localhost:3000，用演示账号登录，把第一个商品加入购物车，并确认购物车徽标显示 1。
访问 https://myapp.example.com/pricing，检查 1280px 宽视口下 Pro 套餐卡片为何溢出容器，并给出 CSS 修复建议。
打开 http://localhost:5173，访问主菜单链接的所有页面，收集所有控制台错误并在源码中修复。
浏览 https://staging.example.com，跟随所有内部链接最多两层，生成一份 Markdown 文档描述每个页面及其主要功能。

工具能力 6

browser_navigate 写入

导航到指定URL。

browser_act 写入

在页面上执行操作（如点击、输入、悬停等）。

browser_extract 只读

从页面提取结构化数据或文本。

browser_evaluate 写入

在页面上下文中执行JavaScript代码。

browser_console 只读

获取或清除浏览器控制台日志。

browser_screenshot 只读

截取当前页面截图（用于视觉调试）。

使用场景

对用户流程进行冒烟测试：打开本地应用，登录，添加商品，验证购物车徽章。

调试样式问题：检查特定页面元素在特定视口下的溢出问题，并建议CSS修复。

修复控制台错误：遍历所有页面，收集控制台错误，并在源码中修复。

映射和文档化应用：探索站内链接，生成每个页面及其主要功能的Markdown文档。

生成端到端测试：为注册流程编写Cypress测试，覆盖正常路径和验证错误。

探索性测试：对应用进行10分钟探索性测试，尝试表单中的边缘输入并报告问题。

支持客户端

Claude Desktop

VS Code

Cursor

依据项目文档列出，未经本站实测。

详细介绍

kogiQA MCP Web Browser 是一个基于 Model Context Protocol (MCP) 的服务器，利用 kogiQA 浏览器控制算法提供浏览器自动化能力。它允许大语言模型通过自然语言与网页交互，无需截图或视觉模型，也无需CSS选择器，节省时间和令牌。适用于调试样式问题、自动修复控制台错误、映射和记录Web应用功能、自动编写端到端测试以及自动化探索性测试。