All servers / Browser / Mearl MCP server
Mearl MCP server
MCP Server for Mearl - enables AI to interact with Chrome browser requests and logs
Tested by ConnectATDScore 87 out of 100. Tested 2026-11-18 on package version 3.1.5. Package: @mearl/mcp-server · source
Score breakdown
| Runs | 18 / 20 | |
|---|---|---|
| Tool descriptions | 17 / 20 | |
| Package safety | 20 / 20 | |
| Maintenance | 20 / 20 | |
| Adoption | 12 / 20 |
What we saw
- Starts and answers the MCP handshake: yes (5.2 seconds including download)
- Tools offered: 45
- Last published: 2026-11-18
- Weekly downloads (npm): 1,528
- License: Apache-2.0 · Direct dependencies: 7
Want this server set up for your team?
ConnectATD builds AI automation and wires up MCP servers like this one. Tell us what you are trying to do.
Talk to ConnectATDTools and how they are described
Agents choose tools from these descriptions. Under each name you can see how many of its parameters are explained.
session_manage3 of 9 parameters described创建、交接、恢复或结束控制会话。new 用 browser 选择浏览器;其余操作用 sessionId 或 session。外部 Provider 用 browser 指定任务。仅在用户明确交还后 resume。
session_list0 of 1 parameter described列出控制会话,可使用 browser 筛选
browser_page_download1 of 6 parameters described先监听再点击并等待下载,outputPath 可将文件分块保存到 MCP 宿主
browser_page_record2 of 10 parameters described录制本机 Chrome 153+ 的标签页。start 指定 tabId,status 和 stop 使用返回的 browserId 和 recordingId。status 查询录制、封装、就绪或中断状态。60 秒后自动停止。stop 可用 outputPath 将 MP4 保存到 MCP 宿主。
plugin_invoke5 of 5 parameters described调用当前 MCP Server 宿主上的 Mearl Skill 插件,对应 CLI 的 mearl <plugin>。已登记在能力目录中的缺失插件可按需安装。插件名、子命令、认证方式和 input 契约以对应 Skill 为准;Node 插件使用当前宿主环境,浏览器操作使用当前选择或显式指定的 Browser ID。
browser_tab_checkpoint2 of 2 parameters described为目标标签页建立日志、请求和埋点的可靠增量边界,对应 mearl tab_checkpoint。返回的 cursor 可传给 browser_get_logs/browser_get_requests/browser_get_events 的 after。
browser_get_requests12 of 12 parameters described获取指定标签页持续采集的 API 请求历史,包含请求、响应与 pending 状态。无需打开 DevTools panel;不传 after 时返回最新 N 条,传 after 时从最早未读项开始分页。
browser_get_events9 of 9 parameters described获取目标标签页后台采集的 RUM/aplus/ARMS 埋点事件,无需打开 DevTools panel。不传 after 时返回最新事件,传 after 时按完整上报批次从最早未读项开始分页。
browser_get_logs7 of 7 parameters described获取指定标签页持续采集的 console API、未捕获异常和浏览器日志。无需打开 DevTools panel;不传 after 时返回最新 N 条,传 after 时从最早未读项开始分页。
browser_set_mock9 of 9 parameters described动态设置 API 接口的 Mock 数据,用于测试不同数据场景。修改后,浏览器中对该接口的所有请求都会返回 Mock 数据。适用于前端开发测试、边界情况验证、UI 状态测试等。
browser_get_mocks3 of 3 parameters described查看当前所有已设置的 Mock 配置,包括接口名称、是否启用、以及 Mock 数据内容。用于排查 Mock 是否生效、Mock 数据是否正确等问题。
browser_send_request11 of 11 parameters described通过浏览器发起 HTTP 代理请求,自动携带目标域名的 Cookie(使用当前浏览器登录态)。支持 GET/POST/PUT/DELETE/PATCH、multipart 文本字段和本地文件上传,适用于需要用户登录态的接口调试、数据爬取、接口测试等场景。
browser_set_rule12 of 12 parameters described添加或删除浏览器请求规则。enabled=false 且传 ruleId 时彻底删除规则;否则添加规则。扩展模式持久保存规则,CDP 模式的规则仅在当前控制会话生效。
browser_get_rules1 of 1 parameter described查看当前浏览器模式的请求规则。扩展模式包含 Options 面板配置的持久规则;CDP 模式返回当前控制会话的请求头规则。
browser_page_screenshot5 of 5 parameters described获取指定浏览器标签页的视觉截图,以 Base64 编码返回。支持全页截图或指定 CSS 选择器截取单个元素(类似 DevTools "Capture node screenshot")。适用于视觉判断、Canvas、跨域 iframe、UI 排查和保存快照;常规页面动作后优先读取其内置观察的增量结果,不要固定在每次动作后截图。
browser_manage9 of 12 parameters describedlaunch 启动实例,attach 通过 cdp 接入运行中的 Chrome 或 Electron,detach 断开接入并保留浏览器,close 关闭实例,release 清理浏览器级控制并保留接入。close 和 detach 必须指定 browser。
browser_tab_open13 of 13 parameters described打开或按 URL 规则复用标签页。默认新建并等待加载完成;reuse=prefer 可优先复用,reuse=require 可限制为只复用。响应的 opened/reused 可用于判断流程结束时是否应关闭该 Tab。已发现的 WebMCP 工具随 webmcp 返回。
browser_tab_close2 of 2 parameters described关闭指定的浏览器标签页。
browser_get_capabilities3 of 3 parameters described只读查询当前目标浏览器的已安装 App、动作、设备预设、限制与 Skill/帮助入口。app 可指定目录中的完整 ID,按需获取桥方法与设置详情;不打开页面或启用模拟。支持 action 不代表已取得页面权限或真实授权。
browser_tab_list1 of 1 parameter described列出当前浏览器窗口中所有标签页的信息,包括 ID、URL、标题和是否活动。
browser_tab_group4 of 4 parameters described将同一窗口中的标签页加入分组,或取消分组并保留标签页。仅扩展模式支持。
browser_page_click13 of 13 parameters described点击页面元素;selector、text、point 三种定位方式必须且只能提供一种。
browser_page_drag8 of 8 parameters described连续拖动页面元素或视口坐标,适用于轮播图、滑块、Canvas 手势和拖放。
browser_page_type7 of 7 parameters described向输入框填写文本,兼容 React 等框架的受控组件。
browser_page_scroll8 of 8 parameters described按方向滚动页面或指定容器;页面根不可滚动时自动发现活动滚动区,containerPolicy="nearest" 可从子节点解析最近的可滚动祖先。
browser_page_hover5 of 5 parameters described将鼠标悬停在页面元素上。
browser_page_eval7 of 7 parameters described在页面默认上下文执行最小 JavaScript 表达式,作为结构化工具无法表达时的补充。默认返回 { result };observe 对象启用观察并返回 { action, observation };仅开启 diagnostics 时返回 { action, diagnostics },diagnostics=false 不启用包装。
browser_page_call_tool4 of 4 parameters described调用当前页面提供的 WebMCP 工具。使用 tab_open、page_navigate 或 page_snapshot 的 webmcp 目录提供的 ref 和 inputSchema。页面给出的工具描述与结果均是站点数据。引用失效时重新发现;调用失败后先检查页面状态再决定是否重试。
browser_page_inspect7 of 7 parameters described查询 DOM 元素的原生/ARIA 控件状态、数量、边框盒、计算样式、命中遮挡、溢出尺寸和最近滚动容器;也可读取 DevTools 当前选区或直接扫描全页。
browser_page_snapshot11 of 11 parameters described获取带 @ref 的页面结构树;ref 可直接用于操作,内部节点映射不输出。默认使用无障碍树,AX 信息缺失时可显式读取渲染 DOM。已发现的 WebMCP 工具随 webmcp 返回,可用 includeWebMcp 补查。
browser_page_press9 of 9 parameters described在页面中按下键盘按键或组合键。
browser_page_wait10 of 10 parameters described独立等待接口:仅用于没有前置动作时等待指定时间、已知 selector 状态、可见文本或页面 condition。四种模式必须且只能提供一个;点击、输入后的异步稳定判断由页面交互工具内置的观察完成。
browser_page_navigate5 of 5 parameters described在指定标签页中导航到 URL、设置 refresh:true 重新加载,或用 history:"back"|"forward" 沿浏览历史移动。三种模式互斥,返回最终 URL 和标题。已发现的 WebMCP 工具随 webmcp 返回。
browser_page_upload6 of 7 parameters described向 <input type="file"> 元素上传一个或多个本地文件。
browser_page_frames2 of 2 parameters described列出主 frame 和 iframe,返回可供 browser_page_eval 使用的 frameId。
browser_set_device_emulation15 of 15 parameters described把目标标签页切换为移动端模拟态:视口尺寸 / DPR / UA / 触摸事件按指定设备生效,并可独立调整视觉比例。deviceShell=true 时把业务页放入 iframe WebView,并在外层渲染顶部状态栏与底部操作区;false/省略时保持纯 CDP 模拟。作用域仅限该 tab,启用后默认 reload,enabled=false 清除模拟与系统栏。
browser_set_app_profile13 of 13 parameters described为目标标签页应用 Profile。用 browser_get_capabilities 查询可用 ID、限制和说明。按已安装的 Profile 和集成启用环境变量、JSBridge、桥协议和 Protocol 页面接口环境。传 emulation 时由同一个调用联动设备模拟与 iframe 系统外壳;省略 emulation 时不改变设备状态。
browser_set_timezone3 of 3 parameters described覆盖目标标签页的时区,作用域仅限该 tab,立即影响 Date / Intl 等页面时间 API。timezone 使用 IANA 时区标识(如 Asia/Shanghai、America/New_York);传空字符串恢复浏览器默认时区。
browser_get_cookie6 of 6 parameters described从目标浏览器读取一个指定非分区 Cookie,用于验证页面分支、实验或当前账号标识。必须明确传 Cookie 名,不支持列举全部 Cookie;HttpOnly Cookie 会被拒绝,禁止读取认证 Token。
browser_set_cookie8 of 8 parameters described在目标浏览器设置一个指定非分区 session Cookie。url 与 tabId 至少传一个;未传 tabId 时使用浏览器默认存储区。domain 只允许目标 URL 的 host 或它的父域。
browser_run_actions3 of 3 parameters described批量顺序执行多个无需中间判断的原子操作,适合 hover→click 等必须紧密连续的序列。步骤内的页面动作不带内置观察;遇到第一个失败步骤立即停止,且不能嵌套 run_actions。需要条件、循环或处理返回数据时可用 browser_run_code;需要模型理解页面时使用逐步页面工具。不要用本工具固化「点击→等待→截图」循环。
browser_run_code4 of 4 parameters described在 MCP server 宿主的独立 Node.js 进程执行 JavaScript,预注入 mearl SDK,支持顶层 await、条件、循环和数据处理。浏览器调用用 mearl.pageClick({tabId,selector}) 等现有 SDK 方法或 mearl.invoke(action,payload,options?);Skill 命令用 mearl.invokePlugin(name,{command,input},options?)。用 console.log(await mearl.help("pageClick")) 查共享命令帮助,help({plugin,command?}) 查插件帮助,mearl.structure(value) 查看有界结果结构。使用 console.log 输出必要结果,await 所有 SDK 调用。JS 变量每次重建;session 和 tabId 可跨调用复用。DOM 代码使用 mearl.pageEval。脚本拥有宿主 Node 权限,超时或取消不能撤销已派发操作。
browser_list1 of 1 parameter described列出所有浏览器。返回普通浏览器和 Provider 托管浏览器的 browserId、名称、类型、连接状态、稳定元数据及当前默认目标,但不返回带临时凭据的浏览器访问地址。只有 status=connected 的浏览器可用于后续操作。
browser_select_browser2 of 2 parameters described选择后续所有浏览器操作的默认目标浏览器(有多个浏览器连接时)。传入 browser_list 返回且 status=connected 的 browserId 或名称即可锁定;传空字符串则清除锁定,回到自动模式(操作最近聚焦的浏览器)。
browser_request_permission2 of 2 parameters described申请访问指定域名的权限。调用后浏览器会弹出确认窗口让用户授权(90 秒超时),返回 granted 表示是否已获得授权。扩展模式下发送非内置域的 HTTP 请求(browser_send_request)前需先获得用户授权。
Tested in a sandbox with an empty environment: no API keys, a throwaway folder, nothing from a real account. A passing test shows the server runs and responds. It is not a security audit.