浏览器自动化测试工具

Autoconsent MCP是一个基于浏览器自动化的模型上下文协议服务器,专门用于创建和测试Autoconsent规则,使LLM能够在真实浏览器环境中与网页交互、检查同意管理平台(CMPs)并测试规则。

  • by noisysocks
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 noisysocks/autoconsent-mcp

使用说明

自动冷凝器MCP

一种模型上下文协议服务器,提供专门为创建和测试自动生效规则而设计的浏览器自动化功能。该服务器使LLM能够与网页交互,检查同意管理平台(CMP),并在真实的浏览器环境中测试自动生效规则。

[!小心] 此服务器可以访问本地文件和本地/内部IP地址,因为它在您的计算机上运行浏览器。使用此MCP服务器时请小心,以确保不会暴露任何敏感数据。

组件

工具

  • 导航

    • 导航到浏览器中的任何URL
    • 输入:
      • url (字符串,必填):要导航到的URL
  • 截图

    • 捕获整个页面或特定元素的屏幕截图
    • 输入:
      • name (string,必填):屏幕截图的名称
      • width (数字,可选,默认值:1280):截图宽度
      • height (数字,可选,默认值:720):截图高度
      • encoded (boolean,可选):如果为true,则将屏幕截图捕获为base64编码的数据URI(文本),而不是二进制图像内容。默认值为false。
  • 点击

    • 点击页面上的元素
    • 输入: selector (string):用于单击元素的CSS选择器
  • 选择

    • 选择带有Select标签的元素
    • 输入:
      • selector (string):用于选择元素的CSS选择器
      • value (string):要选择的值
  • 评估

    • 在浏览器控制台中执行JavaScript
    • 输入: script (string):要执行的JavaScript代码
  • search_html

    • 输出深度包含给定搜索查询的元素的HTML。使用[…]占位符省略不包含给定查询的元素。
    • 输入: query (string):搜索查询
  • print_element

    • 输出给定元素的完整HTML
    • 输入: selector (string):CSS选择器
  • 测试规则

    • 在给定的URL上测试给定的自动应答规则
    • 输入:
      • url (字符串,必填):要导航到的URL
      • rule (对象,必填):自动生效规则(AutoConsentCPRule)

资源

服务器提供对两种资源的访问:

  1. 控制台日志 (console://logs)

    • 文本格式的浏览器控制台输出
    • 包括来自浏览器的所有控制台消息
  2. 截图 (screenshot://)

    • 捕获的屏幕截图的PNG图像
    • 可通过捕获期间指定的屏幕截图名称访问

安装和设置

先决条件

  • Node.js(版本18或更高)
  • npm

设置

npm install
npm run build

运行服务器

发展:

npm run dev

生产:

npm start

测试地点

npm run serve-test-site

这将在端口8080上启动一个本地HTTP服务器,为 test-site 目录。

测试

npm run test:unit
npm run test:integration

请注意,集成测试要求测试站点正在运行(见上文)。

Claude桌面配置

将以下内容添加到您的Claude Desktop配置中:

{
  "mcpServers": {
    "autoconsent-mcp": {
      "command": "node",
      "args": ["path/to/autoconsent-mcp/dist/index.js"]
    }
  }
}

归属和许可

本项目基于Puppeteer MCP服务器https://github.com/modelcontextprotocol/servers-archived/tree/main/src/puppeteer.

此MCP服务器根据MIT许可证获得许可。这意味着您可以根据MIT许可证的条款和条件自由使用、修改和分发软件。