浏览器日志与点击捕获工具

一个基于Playwright的MCP服务器,提供浏览器日志记录和用户点击事件捕获功能,适用于自动化测试和用户行为分析。

  • by nosnaws
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 nosnaws/browser-helper

使用说明

浏览器助手

提供浏览器日志记录和点击捕获功能的模型上下文协议(MCP)服务器。使用Playwright打开一个持久浏览器窗口,用户可以在MCP服务器捕获事件时与之交互。

目录

安装

你需要 包子 已安装以运行此项目。

bun install

为Playwright安装Chromium:

bunx playwright install chromium

用法

直接用Bun跑步:

bun run index.ts [optional-url]

添加到克劳德代码

claude mcp add browser-helper -- bun run /path/to/browser-helper/index.ts [optional-url]

MCP工具

get_logs

从浏览器中检索控制台日志和未捕获的JavaScript错误。

论据:

名称 类型 必填 描述
head number 否 仅返回前N个日志
tail number 否 仅返回最后N个日志

如果两者都没有 head 也不 tail 指定后,返回所有日志。


get_clicks

从用户交互中检索捕获的点击事件。返回一个列表,首先显示最近的单击。

论据:

名称 类型 必填 描述
head number 否 仅返回前N次点击(最近一次)
tail number 否 仅返回最后N次点击(最旧的)
parent_depth number 否 在单击的元素上方包含N个父节点
child_depth number 否 在点击的元素下方包含N级子节点

退货: 点击事件数组,包含:

  • selector -点击元素的CSS选择器
  • tagName -HTML标记名称
  • attributes -元素属性(不包括类/样式)
  • textContent -元素的文本内容(截断为200个字符)
  • inputValue -输入/文本区域/选择元素的值,或内容可编辑内容(截断为500个字符)。仅适用于表单元素。
  • parents / children -可选DOM上下文,如果 parent_depth 或 child_depth 已指定

get_page_info

返回当前页面的URL和标题。

论据: 无

退货: 对象与 url 和 title 物业。


get_navigations

返回导航历史记录,首先显示最近的导航。

论据:

名称 类型 必填 描述
head number 否 仅返回前N个导航(最近的)

退货: 导航事件数组,包含 timestamp, url,以及 title.