BrowserStack
官方将BrowserStack测试平台的完整功能引入您的AI工具,让团队中的每位开发者和测试人员都能更快速、更轻松地进行测试。
你可以用 BrowserStack MCP 做什么?
- 在真实设备上进行手动应用测试 — 要求在你的特定设备(如 iPhone 15 Pro Max)上打开应用,或通过
runAppLiveSession调试 Android 14 上的崩溃问题。 - 跨浏览器网站测试 — 在任何浏览器/操作系统组合上为本地或公共网站启动实时会话,例如使用
runBrowserLiveSession在最新版 Chrome 上打开 browserstack.com。 - 自动化测试执行与调试 — 在 BrowserStack 基础设施上运行 Selenium、Playwright 或 Appium 测试套件,然后通过
getFailureLogs和fetchRCA获取失败日志和根本原因分析。 - 测试用例与运行管理 — 使用自然语言通过
createTestCase和addTestResult创建项目、文件夹、测试用例和测试运行,然后更新结果。 - 带 AI 修复的无障碍扫描 — 扫描本地或生产网站以发现 WCAG 问题,并通过
startAccessibilityScan和fetchAccessibilityIssues获取建议修复方案。 - AI 驱动的测试生成与自愈 — 从 PRD 生成测试用例,将手动测试转换为低代码自动化,并使用
createLCASteps和fetchSelfHealedSelectors修复不稳定的选择器。
文档
BrowserStack MCP 服务器
综合测试平台
直接在 Cursor、Claude 或任何支持 MCP 的客户端中,用自然语言管理测试用例、执行手动或自动化测试、调试问题,甚至修复代码。
随时随地测试:
轻松将 BrowserStack 测试平台连接到您喜爱的 AI 工具,如 IDE、LLM 或智能体工作流。
用自然语言测试:
使用自然语言提示词管理、执行、调试测试,甚至修复代码。
减少上下文切换:
保持心流状态——将所有项目上下文集中在一处,直接从您的 IDE 或 LLM 触发操作。
⚡️ 一键 MCP 设置
点击下方按钮,在您对应的 IDE 中安装 MCP:
注意: 托管的远程 MCP 服务器(
mcp.browserstack.com)现在完全无状态,基于 Streamable HTTP——任何支持 Streamable HTTP 的客户端(Claude、Cursor、VS Code、ChatGPT)均可直接连接,无需修改配置。
注意:请确保您使用的 Node 版本 >= 18.0
- 使用
node --version检查您的 Node 版本。推荐版本:v22.15.0(LTS) - 升级 Node:
-
- 在 macOS 上
(Homebrew) - brew update && brew upgrade node or if using (nvm) - nvm install 22.15.0 && nvm use 22.15.0 && nvm alias default 22.15.0
- 在 macOS 上
-
- 在 Windows 上
(nvm-windows) : nvm install 22.15.0 && nvm use 22.15.0
- 在 Windows 上
- 👉 或直接下载 Node.js LTS 安装程序
.
💡 使用示例
📱 手动应用测试
在最新操作系统版本的真实设备上测试移动应用。无需繁琐设置即可复现 Bug 并调试崩溃问题。 以下是一些示例提示词,帮助您在 BrowserStack 庞大的真实设备云上使用您的移动应用:
# Open app on specific device
"open my app on a iPhone 15 Pro Max"
# Debug app crashes
"My app crashed on Android 14 device, can you help me debug?"
- 与模拟器不同,您可以在真实设备上测试应用的真实性能。借助先进的应用性能分析功能,您可以实时调试崩溃和性能问题。
- 从我们的设备矩阵访问所有主流设备和操作系统版本。我们拥有严格的 SLA,确保在发布日当天在我们的全球数据中心提供新发布的设备。
🌐 手动 Web 测试
与应用测试类似,您可以使用以下提示词在 BrowserStack 庞大的真实浏览器和设备云上测试您的网站。您的机器上没有安装 Edge 浏览器?我们已为您准备好!
# Test your websites
"open my website hosted on localhost:3001 on Edge"
"open browserstack.com on latest version of Chrome"
- 在不同浏览器和设备上测试网站。我们支持所有主流浏览器,覆盖所有主流操作系统。
- 无缝测试本地机器上托管的网站,无需部署到远程服务器!
🧪 自动化测试(Playwright、Selenium、A11y 等)
直接在您的 IDE 或 LLM 中自动分析、诊断甚至修复损坏的测试脚本。即时获取日志、识别根本原因并应用上下文感知的修复。不再需要反复调试。 以下是一些示例提示词,用于在 BrowserStack 的测试平台上运行/调试/修复您的自动化测试。
注意: 当获取测试的根本原因分析(RCA)时,服务器仅将建议的修复作为提案返回。它绝不会自动应用代码更改——您的助手必须展示建议并等待您明确批准后才能编辑任何文件。
#Port test suite to BrowserStack
"Setup test suite to run on BrowserStack infra"
#Run tests on BrowserStack
“Run my tests on BrowserStack”
#AI powered debugging of test failures
"My App Automate tests have failed, can you help me fix the new failures?"
- 利用我们行业领先的测试可观测性功能,修复 CI/CD 流水线报告的测试失败。更多信息请点击此处。
- 在 BrowserStack 的测试平台上运行使用 Jest、Playwright、Selenium 等编写的测试。
🌐 无障碍测试
通过自动化的本地 a11y 扫描及早发现无障碍问题。获得一键式、AI 建议的修复方案。无需查阅文档,无需 CI 意外。使用我们的无障碍测试工具确保符合 WCAG 和 ADA 标准。
#Scan accessibility issues while development
"Scan & help fix accessibility issues for my website running locally on localhost:3000"
#Scan accessibility issues on production site
“Run accessibility scan & identify issues on my website - www.bstackdemo.com”
📋 测试管理
使用自然语言创建和管理测试用例、创建测试计划并触发测试运行。以下是一些示例提示词,帮助您通过 MCP 服务器使用 BrowserStack 的测试管理功能。
# Create project & folder structure
"create new Test management project named My Demo Project with two sub folders - Login & Checkout"
# Add test cases
"add invalid login test case in Test Management project named My Demo Project"
# List added test cases
"list high priority Login test cases from Test Management project - My Demo Project"
# Create test run
"create a test run for Login tests from Test Management project - My Demo Project"
# Update test results
"update test results as passed for Login tests test run from My Demo Project"
🧪 访问 BrowserStack AI 智能体
从 PRD 生成测试用例、将手动测试转换为低代码自动化,并自动修复不稳定的脚本——这一切均由 BrowserStack 的 AI 智能体驱动,无缝集成到您的工作流程中。以下是一些示例提示词,帮助您访问 BrowserStack AI 智能体:
#Test case generator agent
"With Browserstack AI, create relevant test cases for my PRD located at /usr/file/location"
#Low code authoring agent
“With Browserstack AI, automate my manual test case X, added in Test Management”
#Self healing agent
“Help fix flaky tests in my test script with Browserstack AI self healing”
🛠️ 安装
📋 MCP 设置前提条件
注意:请确保您使用的 Node 版本 >= 18.0
- 使用
node --version检查您的 Node 版本。推荐版本:v22.15.0(LTS)
一键 MCP 设置
点击下方按钮,在您对应的 IDE 中安装 MCP:
MCP 服务器设置的其他方式
-
创建 BrowserStack 账户
-
如果您还没有账户,请注册 BrowserStack。
-
ℹ️ 如果您有开源项目,我们可以为您提供免费计划。
-
拥有账户(并购买了相应计划)后,请从账户设置中记下您的
username和access_key。
-
-
注意:请确保您使用的 Node 版本 >=
18.0- 使用
node --version检查您的 Node 版本。推荐版本:v22.15.0(LTS)
- 使用
-
安装 MCP 服务器
-
VSCode(Copilot - 智能体模式):
.vscode/mcp.json:-
查找或创建配置文件: 在项目的根目录中,查找名为 .vscode 的文件夹。该文件夹通常是隐藏的,您需要按照展开说明中的方式找到它。
-
如果该文件夹不存在,请创建它。
-
在 .vscode 文件夹内,创建一个名为 mcp.json 的新文件。
-
添加配置:打开 mcp.json 文件,然后添加以下 JSON 内容。
-
将 username 和 <access_key> 替换为您的 BrowserStack 凭据。
-
{ "servers": { "browserstack": { "command": "npx", "args": ["-y", "@browserstack/mcp-server@latest"], "env": { "BROWSERSTACK_USERNAME": "<username>", "BROWSERSTACK_ACCESS_KEY": "<access_key>" } } } }- 在 VSCode 中,请务必点击 MCP 服务器中的
Start按钮来启动服务器。
**在 VSCode Copilot 上设置 MCP 的其他方式
- 点击齿轮图标以选择工具
2. 顶部中央会出现一个工具菜单,向下滚动菜单顶部,然后点击“添加 MCP 服务器”
3. 选择 NPM 包选项(从 NPM 包安装)- 列表中的第 3 项
4. 输入 NPM 包名称(@browserstack/mcp-server)
5. 输入 BrowserStack 用户名和访问密钥
- 对于 Cursor:
.cursor/mcp.json:
{ "mcpServers": { "browserstack": { "command": "npx", "args": ["-y", "@browserstack/mcp-server@latest"], "env": { "BROWSERSTACK_USERNAME": "<username>", "BROWSERSTACK_ACCESS_KEY": "<access_key>" } } } }- Claude Desktop:
~/claude_desktop_config.json:
{ "mcpServers": { "browserstack": { "command": "npx", "args": ["-y", "@browserstack/mcp-server@latest"], "env": { "BROWSERSTACK_USERNAME": "<username>", "BROWSERSTACK_ACCESS_KEY": "<access_key>" } } } }- Cline
-
点击导航栏中的“MCP 服务器”图标 选择“已安装”选项卡。点击面板底部的“配置 MCP 服务器”按钮。
{
"mcpServers": {
"browserstack": {
"command": "npx",
"args": ["-y", "@browserstack/mcp-server@latest"],
"env": {
"BROWSERSTACK_USERNAME": "<username>",
"BROWSERSTACK_ACCESS_KEY": "<access_key>"
}
}
}
}
文件与应用上传: 上传本地文件/应用的工具(
uploadProductRequirementFile、takeAppScreenshot、runAppTestsOnBrowserStack、runAppLiveSession)需要将MCP_UPLOAD_BASE_DIR环境变量设置为包含这些文件的目录;上传仅限于该目录。
💡 BrowserStack MCP 工具列表
截至目前,我们支持 46 个工具。
远程 MCP 说明: 标记为 (在远程 MCP 中不可用) 的工具依赖本地文件/进程状态,在多租户远程 MCP 服务器中被禁用。它们在本地(npx)设置中可用。
🧾 测试管理
createProjectOrFolder— 创建测试管理项目和/或文件夹以组织测试用例。返回文件夹 ID、项目 ID 和用于访问 TM 项目仪表盘的测试管理链接。 提示词示例
Create a new Test Management project named 'Shopping App' with two folders - Login and Checkout
createTestCase— 在特定项目/文件夹下添加手动测试用例(使用项目标识符如 PR-xxxxx 和文件夹 ID)。 提示词示例
Add a test case named 'Invalid Login Scenario' to the Login folder in the 'Shopping App' project with PR-53617, Folder ID: 117869
updateTestCase— 更新现有测试用例。可以更改任意字段子集(名称、优先级、状态、步骤、标签等);仅修改提供的字段。 提示词示例
Update test case TC-482 in the 'Shopping App' project and set its priority to high
listTestCases— 列出项目的测试用例,可选择限定到某个文件夹(支持 case_type、priority 等过滤条件以及分页)。 提示词示例
List all high-priority test cases in the 'Shopping App' project with project_identifier: PR-59457
listFolders— 列出测试管理项目中的文件夹(返回每个文件夹的 ID、名称、用例数和子文件夹数)。传入 parent_id 可列出子文件夹。 提示词示例
List all folders in the 'Shopping App' project with project_identifier: PR-59457
listTestCaseTemplates— 列出带有数字 template_id 的测试用例模板,用于配合createTestCase应用自定义模板。 提示词示例
List the available test case templates in the 'Shopping App' project
createTestRun— 为项目中的选定测试用例创建测试运行(套件)。 提示词示例
Create a test run for the Login folder in the 'Shopping App' project and name it 'Release v1.0 Login Flow'
listTestRuns— 列出项目的测试运行(按日期、负责人、状态过滤)。 提示词示例
List all test runs from the 'Shopping App' project that were executed last week and are currently marked in-progress
updateTestRun— 更新测试运行的名称/状态和/或向其添加测试用例。 提示词示例
Update test run ID 1043 in the 'Shopping App' project and mark it as complete with the note 'Regression cycle done'
addTestResult— 为运行中的测试用例添加手动执行结果(通过/失败/阻塞/跳过)。 提示词示例
Mark the test case 'Invalid Login Scenario' as passed in test run ID 1043 of the 'Shopping App' project
createTestCasesFromFile— 使用测试用例生成器 AI 智能体从上传的文件批量生成测试用例。 (在远程 MCP 中不可用) 提示词示例
Upload test cases from '/Users/xyz/testcases.pdf' to the 'Shopping App' project in Test Management
listTestPlans— 列出项目中的测试计划(TP-*),包含名称、状态、日期以及活动/已关闭运行计数。支持分页。 提示词示例
List all test plans in the 'Shopping App' project with project_identifier: PR-59457
getTestPlan— 按标识符(TP-*)获取测试计划,包含其元数据、关联的测试运行、总测试用例数和状态摘要。 提示词示例
Get the details of test plan TP-120 in the 'Shopping App' project
listSubTestPlans— 列出父测试计划(TP-)下的子测试计划(STP-)。支持分页。 提示词示例
List sub-test-plans under test plan TP-120 in the 'Shopping App' project
getSubTestPlan— 获取父计划下的子测试计划(STP-*),包含其元数据和关联的测试运行。 提示词示例
Get sub-test-plan STP-45 under test plan TP-120 in the 'Shopping App' project
⚙️ BrowserStack SDK 设置 / 自动化测试
setupBrowserStackAutomateTests— 集成 BrowserStack SDK 并在 BrowserStack 上运行 Web 测试。对于视觉测试/Percy,请使用专用的 Percy 工具。 提示词示例
Run my Selenium-JUnit5 tests written in Java on Chrome and Firefox.
fetchAutomationScreenshots— 获取给定 Automate/App Automate 会话期间捕获的截图。 提示词示例
Get screenshots from Automate session ID abc123xyz for my desktop test run
listSessions— 列出 Automate/App Automate 构建中的会话。每条记录包含sessionId、name、status、os、osVersion、browser、device、browserUrl(仪表盘链接)和videoUrl,支持可选的limit/offset分页以及客户端status过滤。接受来自仪表盘 URL 的哈希构建 ID 或由getBuildId/listBuildId返回的可观测性构建 ID——可观测性 ID 会通过构建的会话自动解析为哈希 ID。返回的sessionId值可与getFailureLogs、fetchAutomationScreenshots和fetchSelfHealedSelectors配合使用。 提示词示例
List sessions for Automate hashed build ID <hashed build id>
🔍 可观测性
getFailureLogs— 检索 Automate/App Automate 会话的错误日志。App Automate 日志端点基于构建范围,因此需要哈希构建 ID — 如果有请传入,否则将从会话中自动解析。 提示示例
Get the Appium logs for App Automate session ID <session id>
fetchBuildInsights— 通过结合构建详情和质量门结果获取 BrowserStack 构建的洞察。包括hashed_id(listSessions接受的哈希构建 ID)和session_type,当构建在 Automate / App Automate 上运行时,通过构建的会话解析。 提示示例
Get the build insights for build UUID <your-build-uuid> on BrowserStack
📱 App Live
runAppLiveSession— 在云端的真实设备上启动手动应用测试会话。 提示示例
Open my app on iPhone 15 Pro Max with iOS 17. App path is /Users/xyz/app.ipa
💻 Live
runBrowserLiveSession— 在桌面或移动浏览器上启动网站测试的 Live 会话。 提示示例
Open www.google.com on the latest version of Microsoft Edge on Windows 11
📲 App Automate
takeAppScreenshot— 在指定设备上启动应用并捕获快速验证截图,以确认应用已启动。 提示示例
Take a screenshot of my app on Google Pixel 6 with Android 12 while testing on App Automate. App file path: /Users/xyz/app-debug.apk
runAppTestsOnBrowserStack— 通过直接上传编译的 .apk/.ipa 测试文件,运行预构建的原生移动测试套件(Espresso/XCUITest)。 提示示例
Run Espresso tests from /tests/checkout.zip on Galaxy S21 and Pixel 6 with Android 12. App path is /apps/beta-release.apk under project 'Checkout Flow'
setupBrowserStackAppAutomateTests— 为基于 Appium 的移动应用测试设置 BrowserStack App Automate SDK 集成。 提示示例
Set up my Appium test suite to run on BrowserStack App Automate
♿ 无障碍
accessibilityExpert— 向 A11y 专家咨询(WCAG 2.0/2.1/2.2、移动/网页可用性、最佳实践)。 提示示例
What WCAG guidelines apply to form field error messages on mobile web?
startAccessibilityScan— 启动网页无障碍扫描并检索本地 CSV 报告路径。 提示示例
Run accessibility scan for "www.example.com"
createAccessibilityAuthConfig— 为登录后的无障碍扫描创建认证配置(基于表单或基本认证)。 提示示例
Create a basic-auth accessibility config named 'site-login' for https://www.example.com with username testuser and password <password>
getAccessibilityAuthConfig— 按 ID 检索现有的无障碍认证配置。 提示示例
Get accessibility auth config with ID <config-id>
fetchAccessibilityIssues— 从已完成的扫描中获取无障碍问题,支持分页。 提示示例
Fetch the accessibility issues for scan ID <scan-id> and scan run ID <scan-run-id>
🎨 Percy 视觉测试
percyVisualTestIntegrationAgent— 将 Percy 视觉测试集成到新项目中,并通过逐步模拟演示视觉变化检测。 提示示例
Integrate Percy for this project
expandPercyVisualTesting— 为现有项目设置或扩展 Percy 视觉测试覆盖(Percy Web Standalone 和 Percy Automate)。 提示示例
Expand Percy coverage for this project
addPercySnapshotCommands— 将 Percy 快照命令添加到指定的测试文件中。(在远程 MCP 中不可用) 提示示例
Add Percy snapshot commands to my Cypress test files
listTestFiles— 列出给定目录集合的所有测试文件。(在远程 MCP 中不可用) 提示示例
List the test files under my ./tests directory
runPercyScan— 运行 Percy 视觉测试扫描。(在远程 MCP 中不可用) 提示示例
Run this Percy build
fetchPercyChanges— 检索并总结 Percy AI 在最新构建与先前构建之间检测到的视觉变化。 提示示例
Summarize the visual changes Percy detected in my latest build
managePercyBuildApproval— 批准或拒绝 Percy 构建。 提示示例
Approve the latest Percy build
🤖 BrowserStack AI 代理
uploadProductRequirementFile— 上传 PRD/截图/PDF 并获取文件映射 ID(与createTestCasesFromFile一起使用)。(在远程 MCP 中不可用) 提示示例
Upload PRD from /Users/xyz/Desktop/login-flow.pdf and use BrowserStack AI to generate test cases
createLCASteps— 从测试管理中的手动测试用例生成低代码自动化(LCA)步骤。 提示示例
Convert the manual test case 'Add to Cart' in the 'Shopping App' project into LCA steps
fetchSelfHealedSelectors— 检索 AI 自愈选择器(以及测试源代码),以修复由 DOM 变化引起的脆弱测试。 提示示例
Fetch and fix flaky test selectors in Automate session ID session_9482 using MCP
prepareSelfHealingPlan— 构建一个自愈编辑计划,将定位器对与测试源代码捆绑在一起,供您的 LLM 应用。本身不会修改文件。 提示示例
Prepare a self-healing plan from the self-healed selectors for my build
fetchRCA— 为失败的 Automate/App-Automate 测试(按数字测试 ID)获取 AI 根本原因分析。仅建议修复;从不自动应用。 提示示例
Fetch the root cause analysis for failed test IDs 101 and 102 on BrowserStack
getBuildId— 获取给定项目和构建名称的 BrowserStack 构建 ID,范围限定在您的构建中。 提示示例
Get the build ID for build 'nightly-regression' in project 'Checkout Flow'
listBuildId— 获取项目和构建名称的最新构建 ID,跨所有用户(无用户过滤)。 提示示例
Get the latest build ID for build 'nightly-regression' in project 'Checkout Flow'
listTestIds— 列出 BrowserStack 构建(Automate 或 App Automate)中的测试,包含每个测试的status和session_id,可选按状态过滤(通过/失败/待定/跳过)。session_id直接提供给getFailureLogs和fetchAutomationScreenshots。 提示示例
List the failed test IDs from build UUID <your-build-uuid> on BrowserStack
askBrowserStackAI(Alpha,有限可用性) — 用自然语言将多步骤任务交给 BrowserStack 的代理;它决定调用哪些方法并返回答案及其执行的步骤。涵盖测试管理和测试报告与分析。任何会更改数据的操作都会在您的客户端中暂停等待确认;删除操作被直接拒绝。需要账户已注册 — 否则返回权限错误且不执行任何操作。 提示示例
Find all payment test cases in project Shopping App and add the 'regression' tag to them
🚀 远程 MCP 服务器
远程 MCP 具备 MCP 服务器的所有功能,无需复杂的设置或本地安装。
主要优势:
-
✅ 在企业网络中无缝运行,无需担心防火墙、二进制文件或不允许本地安装的情况。
-
✅ 安全的 OAuth 集成 — 无需共享密码或手动处理凭据。
限制:
- ❌ 不支持本地测试(无法测试 VPN、防火墙或 localhost 后的应用)。如果必须进行本地测试,则需要使用 BrowserStack 本地 MCP 服务器。
- ❌ 延迟可能略高,但不会很明显 — 在正常使用中通常不会注意到。
安装步骤:
-
在 VSCode(Copilot - 代理模式)上:
.vscode/mcp.json:-
查找或创建配置文件:
-
在项目的根目录中,查找名为 .vscode 的文件夹。此文件夹通常隐藏,您需要按照展开中的说明找到它。
-
如果此文件夹不存在,请创建它。
-
在 .vscode 文件夹内,创建一个名为 mcp.json 的新文件。
-
要设置远程 BrowserStack MCP 而不是本地 BrowserStack MCP,您可以添加以下 JSON 内容:
设置远程 MCP 的替代方法
-
步骤 1. 点击齿轮图标以选择工具
-
步骤 2. 顶部中央会出现一个工具菜单,向下滚动菜单,然后点击添加 MCP 服务器
-
步骤 3. 点击 HTTP 选项
-
步骤 4. 粘贴远程 MCP 服务器 URL:https://mcp.browserstack.com/mcp
-
步骤 5. 将服务器 ID 设置为:browserstack
-
步骤 6. 在 VSCode 中点击启动 MCP 服务器,然后点击“允许”
-
🤝 推荐的 MCP 客户端
- 对于自动化测试 + 调试用例,我们推荐使用 Github Copilot 或 Cursor。
- 对于手动测试用例(Live 测试),我们推荐使用 Claude Desktop。
⚠️ 重要说明
- BrowserStack MCP 服务器正在积极开发中,目前支持 MCP 规范的一个子集。更多功能将很快添加。
- 工具调用依赖于 MCP 客户端,而 MCP 客户端又依赖于 LLM,因此可能存在一些非确定性行为,导致意外结果。如果您有任何建议或反馈,请打开一个问题进行讨论。
📝 贡献
我们欢迎贡献!请打开一个问题来讨论您想要做的任何更改。 👉 点击此处查看我们的贡献指南
📞 支持
如需支持,请:
🚀 更多功能即将推出
敬请期待激动人心的更新!有任何建议?请打开一个问题进行讨论。

