WebdriverIO MCP:一个服务管浏览器、Electron 和手机应用
WebdriverIO 官方 MCP。智能体能驱动主流浏览器,也能经 Appium 操作 iOS、安卓原生应用,还支持 Electron 桌面应用。
项目与安装文档
查看项目https://github.com/webdriverio/mcp
同一个产品有网页版、桌面版和手机 App,测试时常常要换三套工具。WebdriverIO MCP 把它们收进一个服务:浏览器走 WebDriver,原生 App 走 Appium,Electron 应用也能直接起会话。它出自 WebdriverIO 项目组织,截至 2026-10-06 只有约 40 star,知道的人还不多。
能做什么
- 统一的会话:
start_session启动浏览器、本地 Electron 应用或手机 App 会话,attach_session接入已有的 WebDriver 或 Appium 会话;每次只能有一个活跃会话。 - 页面和元素:
get_elements只返回可见、可交互的元素,get_accessibility_tree读无障碍树,click_element、set_value操作元素,execute_script执行脚本;还有专门的文档搜索工具query_docs,能查 WebdriverIO 官方文档并带上来源页面。 - 手机专属动作:
tap_element、swipe、drag_and_drop手势,switch_context在原生和 WebView 之间切换,还能旋转屏幕、设置 GPS 位置;noReset、fullReset参数控制每次启动 App 时要不要保留登录状态和已装数据。 - Mock 与云端设备:
mock拦截浏览器请求或 Electron 主进程 API;配置凭据后可在 BrowserStack、Sauce Labs、LambdaTest、TestingBot、Digital.ai 五家云端真机厂商上跑,还能起本机隧道测试内网地址。 - 会话记录:每次工具调用都会被记下来,
wdio://session/current/code这样的 MCP 资源能直接导出一份可独立运行的 WebdriverIO 脚本,云端会话还带上报结果的 try/catch。
适合谁
- 同时维护网页和移动端、想让智能体顺着用户路径走一遍再报告问题的测试工程师。
- 做 Electron 桌面应用、需要智能体帮忙复现界面 bug 的开发者。
接入方式
需要 Node.js;测手机 App 还要装好 Appium 和对应驱动(iOS 需 Xcode,安卓需 Android Studio)。Claude Code 里:
claude mcp add wdio-mcp -- npx -y @wdio/mcp@latest
编辑点评
只测网页的话,Playwright MCP 更省事。这个项目值得关注,是因为它把移动端和 Electron 也纳入了同一套工具接口,一套提示词能覆盖三个平台,这在浏览器类 MCP 里很少见;元素和页面信息用 TOON(Token-Oriented Object Notation)格式返回,比普通 JSON 更省 token。要注意,execute_script 和 execute_electron_script 都能执行任意代码,后者还拿到 Electron 主进程权限;HTTP 模式默认只接受本机来源。同一时间只能维护一个会话,批量跑多设备测试要串行排队,这也是它和支持并发会话的云端测试框架相比最大的短板。手机端的前置环境较重,第一次配置要留出时间。许可证为 MIT。