kogiqa-mcp

kogiqa-mcp 快速入门

MCP 浏览器——AI Agent 的 Web 调试工具，专为复杂 Web 应用开发设计。

这是什么？适合谁？

kogiqa-mcp 是一个 MCP Server，为 AI Agent 提供浏览器能力。与 Puppeteer 或 Playwright 的通用浏览器自动化不同，kogiqa-mcp 专为 AI Agent 调试和开发复杂 Web 应用设计——它提供了面向调试场景的专用工具，如 DOM 检查、网络请求拦截、控制台日志捕获等。

适合：需要 AI Agent 调试 Web 应用的开发者、Web 应用自动化测试、MCP 生态的浏览器工具需求。

准备工作

• Node.js 18+
• MCP 客户端（Claude Code / Codex / 其他 MCP 兼容 Agent）
• Chrome 或 Chromium 浏览器

3 步快速上手

第 1 步：安装

npx @atagon/kogiqa-mcp

或在 MCP 配置文件中添加：

{
  "mcpServers": {
    "kogiqa": {
      "command": "npx",
      "args": ["@atagon/kogiqa-mcp"]
    }
  }
}

第 2 步：连接 MCP 客户端

在 Claude Code 或 Codex 中，kogiqa-mcp 会自动注册为可用的 MCP 工具。

第 3 步：让 AI Agent 使用浏览器

在 Claude Code 中：

请使用 kogiqa 浏览器打开 https://example.com，检查页面是否有 JavaScript 错误

AI Agent 会通过 kogiqa-mcp 启动浏览器、导航到页面、捕获控制台日志并返回分析结果。

进阶用法

DOM 检查

使用 kogiqa 检查 https://myapp.com 的登录表单，列出所有 input 元素的 name 和 type

网络请求拦截

使用 kogiqa 监控 https://myapp.com 的 API 请求，找出所有返回 4xx 的请求

性能分析

使用 kogiqa 分析 https://myapp.com 的加载性能，找出阻塞渲染的资源

常见问题 FAQ

Q1：和 Puppeteer MCP 有什么区别？

A：Puppeteer MCP 偏通用浏览器自动化（截图、PDF 生成、表单填写），kogiqa-mcp 偏调试和开发（DOM 检查、网络拦截、控制台捕获）。如果你是 Web 开发者调试应用，kogiqa-mcp 更合适。

Q2：支持哪些浏览器？

A：基于 Chrome DevTools Protocol，支持 Chrome/Chromium/Edge。Firefox 和 Safari 不支持。

Q3：安全吗？AI Agent 会不会误操作？

A：kogiqa-mcp 在本地运行，浏览器实例是隔离的。AI Agent 的操作受 MCP 工具权限限制，不会执行超出定义范围的操作。

参考链接

• GitHub 仓库