使用说明

项目简介

BrowserStack MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，它将 BrowserStack 强大的测试平台功能（如应用测试、网站测试、自动化测试等）以标准化的方式提供给支持 MCP 协议的客户端（如 Cursor, GitHub Copilot, Claude Desktop）。通过该服务器，用户可以使用自然语言指令，在 MCP 客户端中直接调用 BrowserStack 的云端真机和浏览器资源，进行各种测试和调试工作。

主要功能点

应用真机测试: 在 BrowserStack 提供的海量真机设备云上测试移动应用，获得真实的性能数据和调试体验。
网站跨浏览器测试: 在各种浏览器和设备上测试网站兼容性，支持本地网站测试和截图对比。
自动化测试支持: 集成 BrowserStack 的测试平台，支持运行 Jest, Playwright, Selenium 等多种测试框架编写的自动化测试，并利用 AI 能力辅助分析和修复测试失败。
可访问性测试: 使用 BrowserStack 的可访问性测试工具，确保网站符合 WCAG 和 ADA 标准。

安装步骤

创建 BrowserStack 账号: 访问 BrowserStack 官网注册账号，并在账号设置中获取用户名 (USERNAME) 和访问密钥 (ACCESS_KEY)。
安装 MCP 服务器: 无需手动安装，MCP 客户端（如 Cursor）会自动启动和管理该服务器。只需在 MCP 客户端中配置服务器连接信息即可。

服务器配置

在 MCP 客户端中配置 BrowserStack MCP Server 的连接信息，以下是 Cursor 客户端的配置示例 ( '.cursor/mcp.json' )，其他 MCP 客户端的配置方式可能有所不同，请参考对应客户端的文档：

{
  "mcpServers": {
    "browserstack_mcp_server": {  // 服务器名称，自定义
      "command": "npx",        // 启动命令，通常为 npx 或 node
      "args": ["@browserstack/mcp-server"], // 启动参数，指定要执行的 npm 包
      "env": {                 // 环境变量配置
        "BROWSERSTACK_USERNAME": "<您的 BrowserStack 用户名>", // 替换为您的 BrowserStack 用户名
        "BROWSERSTACK_ACCESS_KEY": "<您的 BrowserStack 访问密钥>"  // 替换为您的 BrowserStack 访问密钥
      }
    }
  }
}

配置说明:

'"command": "npx"' 和 '"args": ["@browserstack/mcp-server"]' 指示 MCP 客户端通过 'npx' 命令运行 npm 包 '@browserstack/mcp-server'，从而启动 BrowserStack MCP 服务器。
'"env"' 部分配置了服务器运行所需的 BrowserStack 账号信息，请务必替换 '<您的 BrowserStack 用户名>' 和 '<您的 BrowserStack 访问密钥>' 为您自己的 BrowserStack 账号信息。

基本使用方法

配置完成后，在 MCP 客户端中，可以使用自然语言指令调用 BrowserStack MCP Server 提供的功能。以下是一些使用示例：

应用测试:
- '在 iPhone 15 Pro Max 上打开我的应用'
- '我的 Android 14 设备上的应用崩溃了，帮我调试一下'
网站测试:
- '在 Windows Edge 浏览器上打开我本地 localhost:3001 的网站并截屏'
- '在三星浏览器上打开 test.com，检查可读性问题'
自动化测试:
- '在 BrowserStack 上运行我的测试套件'
- '我的测试套件失败了，帮我修复新的失败用例'
可访问性测试:
- '检查我的网站 www.mywebsite.com 的可访问性问题'

注意: 具体的指令可能因 MCP 客户端的 LLM 理解而略有差异，建议参考客户端的提示和示例。

关键词