# @browserstack/mcp-server 中文文档 规范地址：https://npmcn.com/package/%40browserstack/mcp-server/ 版本：2\.6\.5 npm 元数据更新时间：2026-11-06T14:06:08.079Z 中文译文更新时间：2026-11-08T16:26:14.128Z 软件包许可：AGPL-3\.0-only 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40browserstack/mcp-server 原文对照：https://npmcn.com/package/%40browserstack/mcp-server/?lang=original 项目主页：https://github.com/browserstack/mcp-server#readme 源码仓库：https://github.com/browserstack/mcp-server ## 关键信息（来自 npm 元数据） - 包体积（解压后）：5.5 MB，412 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - Node.js 要求：\>=20\.9\.0 - 运行依赖：13 个 - 首次发布：2025-04-22T13:54:50.645Z - 最新版本发布：2026-11-06T14:06:07.680Z - 近 30 天下载量：110233（2026-10-09 至 2026-11-07，npm 官方下载统计） - 已发布版本数：193（近 12 个月 155 个） ## 中文简介 浏览器Stack 的官方 MCP 服务器 ## 安装 ```sh npm install @browserstack/mcp-server ``` 也可以使用：`pnpm add @browserstack/mcp-server`、`yarn add @browserstack/mcp-server`、`bun add @browserstack/mcp-server` ## README # 浏览器Stack MCP 服务器 ![BrowserStack Logo](https://npmcn.com/package/%40browserstack/mcp-server/assets/browserstack-logo.png) ![MCP Server Logo](https://npmcn.com/package/%40browserstack/mcp-server/assets/mcp-logo.png) [![NPM Version](https://img.shields.io/npm/v/%40browserstack%2Fmcp-server)](https://www.npmjs.com/package/@browserstack/mcp-server) 综合试验平台 [![BrowserStack server MCP server](https://glama.ai/mcp/servers/@browserstack/mcp-server/badge)](https://glama.ai/mcp/servers/@browserstack/mcp-server) [![](https://npmcn.com/package/%40browserstack/mcp-server/assets/thumbnail.webp)](https://www.youtube.com/watch?v=sLA7K9v7qZc&list=PL1vH6dHT3H7oy8w9CY6L_nxGxCc89VXMX&index=5) 管理测试案例,执行人工或自动化测试,调试问题,甚至直接在Cursor,Claude等工具内固定代码,或者任何MCP启用的客户端,使用简单的英语. #### 任何地方的测试 : 轻松地将浏览器Stack测试平台连接到你最喜欢的AI工具,例如IDes,LLMS,或代理工作流程. #### 自然语言测试 : 管理,执行,调试测试,甚至使用平版英语提示来固定代码. #### 上下文切换减少 : 保持流动——将所有项目上下文保存在一个地方并直接从您的 IDE 或 LLM 触发动作 . ## QQ 点击 MCP 设置 点击下面的按钮在您的 IDE 或 助手中安装 MCP : [![Install in VS Code](https://npmcn.com/package/%40browserstack/mcp-server/assets/one-click-vs-code.png)](http://mcp.browserstack.com/one-click-setup?client=vscode)  [![Add to Copilot](https://npmcn.com/package/%40browserstack/mcp-server/assets/one-click-copilot.png)](https://github.com/mcp?search=browserstack)  [![Add to Cursor](https://npmcn.com/package/%40browserstack/mcp-server/assets/one-click-cursor.png)](https://cursor.com/marketplace/browserstack)  [![Add to Claude](https://npmcn.com/package/%40browserstack/mcp-server/assets/one-click-claude.png)](https://claude.com/marketplace/connectors/mcp-browserstack-com)  [![Add to ChatGPT](https://npmcn.com/package/%40browserstack/mcp-server/assets/one-click-chatgpt.png)](https://chatgpt.com/plugins/plugin_asdk_app_6a8bf7703f1881918317add0244840a8) > **说明:** 主机远程 MCP 服务器(`mcp.browserstack.com`)现在完全无国籍于超流的HTTP——任何可流的-HTTP客户端(Claude, Cursor, VS Code, ChatGPT)与不改变配置连接. > **基罗:** a 用于此服务器的 Kiro 电源 [`integrations/kiro-power`](https://npmcn.com/package/%40browserstack/mcp-server/integrations/kiro-power)在 Kiro IDE 中, 打开 Power 面板 ~ 添加 Custom Power ~ 从 GitHub 导入电源并输入 `https://github.com/browserstack/mcp-server/tree/main/integrations/kiro-power`,或复制此寄存器,并从带有该目录的文件夹中导入电源. #### 先决条件 - 浏览器Stack账户. [报名](https://www.browserstack.com/users/sign_up) 如果您没有; 开源项目可以获得 [免费计划](https://www.browserstack.com/open-source)。 。 。 . -  `username` 财务报告和审定财务报表 `access_key` 从 [账户设置](https://www.browserstack.com/accounts/profile/details)。 。 。 . 任何 MCP 客户端的手动设置参见 [在本地安装 MCP 服务器](https://www.browserstack.com/docs/browserstack-mcp-server/get-started/local-mcp) 或者说 [设置远程 MCP 服务器](https://www.browserstack.com/docs/browserstack-mcp-server/get-started/remote-mcp-server)。 。 。 . #### 注:确保您使用节点版本QQ `22` - 检查您的节点版本 `node --version`。建议版本: `v22.15.0` (电话) - 要升级节点 : - 1. 在磁盘上 `(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` - 2. 在窗口上 `(nvm-windows) : nvm install 22.15.0 && nvm use 22.15.0` - 👉 [或者直接下载节点.js LTS 安装器](https://nodejs.org/en/download) ## 代理辅助设置 大多数AI代理可以添加浏览器Stack MCP服务器,与之相接,并在没有手动配置的情况下走入登录. 将此提示粘入您的代理 : ```text Add the BrowserStack MCP server to this agent, following the setup guide at https://www.browserstack.com/docs/browserstack-mcp-server/get-started/remote-mcp-server and using the server URL https://mcp.browserstack.com/mcp. Once it is added, start the BrowserStack sign-in flow so I can log in. ``` 要自己添加,请使用客户端的命令或菜单: | 客户端 | 命令或配置 | | --- | --- | | 克劳德代码 | `claude mcp add --scope user --transport http browserstack https://mcp.browserstack.com/mcp`运行 `/mcp` 在会话中并签名 | | 克洛德桌面/ Claude.ai | 设置 / 连接器 / 添加自定义连接器, 带有 URL `https://mcp.browserstack.com/mcp` | | 聊天游戏 | 安装 [浏览器Stack 插件](https://chatgpt.com/plugins/plugin_asdk_app_6a8bf7703f1881918317add0244840a8) | | 代码 | `codex mcp add browserstack --url https://mcp.browserstack.com/mcp`,则 `codex mcp login browserstack` 要签名 | | VS 代码 / GitHub 副驾驶 | `code --add-mcp '{"name":"browserstack","type":"http","url":"https://mcp.browserstack.com/mcp"}'`,然后从 MCP 视图启动服务器并签名到 | | 光标 | 添加 `"browserstack": { "url": "https://mcp.browserstack.com/mcp" }` 下级 `mcpServers` 内 `~/.cursor/mcp.json`中,然后从光标设置 → MCP 中签名 | | 任何其他 MCP 客户端 | 指着它 `https://mcp.browserstack.com/mcp` | ## 使用实例 ### QQ 手动应用测试 通过最新的OS版本在真实设备上测试移动应用程序. 重复错误和调试崩溃而不设置麻烦. 下面是一些在浏览器Stack大量真实设备云上使用您的移动应用程序的样本提示 ```bash # 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?" ``` - 与模拟器不同的是,测试你的应用在实际设备上的真实世界性能. 高级 [App- 显示特性](https://www.browserstack.com/docs/app-live/app-performance-testing),可以实时调试相撞和性能问题. - 从我们获取所有主要设备和操作系统版本 [设备网格](https://www.browserstack.com/list-of-browsers-and-platforms/app_live),我们有严格的 SLA 为我们的全球数据中心提供新发布的设备 [发射日](https://www.browserstack.com/blog/browserstack-launches-iphone-15-on-day-0-behind-the-scenes/)。 。 。 . ### 手工网络测试 类似应用测试,您可以使用下列提示来测试您的 **网站** 在浏览器Stack 上大量显示真实浏览器和设备。 机器上没有Edge浏览器吗? 我们掩护你! ```bash # Test your websites "open my website hosted on localhost:3001 on Edge" "open browserstack.com on latest version of Chrome" ``` - 测试跨越不同浏览器和设备的网站. 我们支持 [每个主要浏览器](https://www.browserstack.com/list-of-browsers-and-platforms/live) 每个主要的操作系统. - 无缝测试网站 本地托管在您的机器上, 不需要部署到远程服务器! ### \* 自动化测试(Playwright、硒、A11y等) 自动分析,诊断,甚至修复破损的测试脚本 在您的 IDE 或 LLM 。 即时获取日志,找出根源,并应用上下文感知修正. 不再调试循环. 以下是在浏览器Stack 上运行/调试/修正自动测试的少数示例提示 [测试平台](https://www.browserstack.com/test-platform)。 。 。 . > **说明:** 当获取根因子分析(RCA)进行测试时,服务器返回建议的修补仅作为建议. 它从未自动应用代码更改——您的助手必须在编辑任何文件之前给出建议并等待您的明确批准. ```bash #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管道报告的测试故障 [测试可观察性](https://www.browserstack.com/docs/test-observability) 特性。 查找更多信息 [这里](https://www.browserstack.com/docs/test-observability/features/smart-tags)。 。 。 . - 运行用 Jest, Playwright, Selenium 写的测试, 以及更多关于浏览器Stack 的测试 [测试平台](https://www.browserstack.com/test-platform) ### \* 无障碍 及早通过自动化的本地A11y扫描检查无障碍问题. 获得一击,AI建议修正. 不打官司 不打奇袭 确保WCAG和ADA遵守我们的无障碍测试工具 ```bash #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” ``` ### 测试管理 使用自然语言创建并管理测试案例,创建测试计划并触发测试运行. 以下是一些使用浏览器Stack的能力的提示 [测试管理](https://www.browserstack.com/test-management) 与 MCP 服务器. ```bash # 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" ``` ### QQ 装入测试 在不离开您的 IDE 或聊天的情况下按尺度运行和分析负载测试——找到测试,开始并停止运行,读取报告和AI Insights,比较运行,并检查您的VU小时. 与API(JMeter, k6, Gatling, Locust),浏览器(Playwright, Selenium, WebdriverIO, Nightwatch)和浏览器Stack 上的混合负载测试合作 [装入测试](https://www.browserstack.com/load-testing)这些通过 [核心工具](https://npmcn.com/package/%40browserstack/mcp-server/#readme--core-tools)。 。 。 . ```bash # Find a test "find my load test called checkout-api" # Run it "run checkout-api for 5 minutes with 100 virtual users" # Check on it "is my checkout-api run finished yet?" # Read the results "what was the p95 response time and error rate of the last checkout-api run?" # Compare two runs of the same test "did the latest checkout-api run regress compared with the previous one?" # Check quota before a big run "how many VU-hours do I have left, and what would a 30-minute run with 500 VUs cost?" ``` ### QQ 访问浏览器Stack AI 代理 从 PRD 生成测试案例, 将手动测试转换为低码自动化, 下面是访问浏览器 AI 代理的提示 ```bash #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” ``` ## ++ 核心工具 有五个核心工具让你的AI助手找到并运行任何浏览器Stack工作流程. 您的助手在每次会话开始时都会加载 MCP 服务器所曝光的每个工具, 因此每个工作流程有一个工具会填充您的上下文窗口并减慢整个会话 。 相反,你的助手使用核心工具来搜索浏览器Stack工具的简明语言目录并运行它所需要的工具. | 工具 | 说明 | | --- | --- | | `listProducts` | 在目录中列出浏览器Stack产品,并简要说明每个产品覆盖的内容 | | `describeEntity` | 解释一个实体:其别名、ID格式、父实体和相关实体以及采取行动的能力 | | `searchCapability` | 找到匹配简单语言请求的能力, 以及您助理运行每个请求所需的一切 | | `describeCapability` | 返回一个能力的全部细节,例如其参数、请求正文和响应格式 | | `invokeCapability` | 运行一个能力,并返回产品的反应不变. 数据变化需要您批准 | 见 [核心工具](https://www.browserstack.com/docs/browserstack-mcp-server/tools/core-tools) 参数和如何核准数据变化. **所有工具** -见 [文件/文件](https://npmcn.com/package/%40browserstack/mcp-server/docs/TOOLS.md) 用于按产品编排的每个工具,或 [浏览器Stack MCP 工具和工作流程](https://www.browserstack.com/docs/browserstack-mcp-server/tools) 用于产品工作流程. > **文件应用上传( A) :** 上传本地文件/应用程序的工具( e)`uploadProductRequirementFile`, (中文(简体) ), `takeAppScreenshot`, (中文(简体) ), `runAppTestsOnBrowserStack`, (中文(简体) ), `runAppLiveSession`要求 `MCP_UPLOAD_BASE_DIR` env var 设定为包含这些文件的目录;上传仅限于此. ## 远程 MCP 服务器 远程MCP与一个MCP服务器的所有功能相伴而来,没有复杂设置或局部安装的麻烦. ### 主要好处: - QQ在企业网络中无缝工作,不担心防火墙或二进制或者不允许局部安装的地方. - QQ安全 OAuth 集成 – 没有密码共享或手动认证处理. ### 限制: - QQ 本地测试支持( 无法在 VPN 、 防火墙 或 localhost 后测试应用) 。 如果您需要进行本地测试, 您必须使用浏览器Stack本地 MCP 服务器 . - 但没什么大不了的. ## 重要笔记 - 浏览器Stack MCP服务器正在积极开发中,目前支持MCP spec的一个子集. 很快会增加更多的功能. - 工具引用依赖于MCP客户端,而MCP客户端又依赖于LLM,因此可能有一些非决定性的行为会导致出乎意料的结果. 如果您有任何建议或反馈,请开始讨论. ## 捐款 我们欢迎捐款! 请打开一个问题 讨论任何你想做的改变. 👉 [**单击这里查看我们的贡献准则**](https://github.com/browserstack/mcp-server/blob/main/CONTRIBUTING.md) ## ++ 辅助 支持请: - 打开我们的问题 [GitHub 仓库](https://github.com/browserstack/mcp-server) 如果您面临与MCP服务器相关的任何问题. - 联系我们 [支助小组](https://www.browserstack.com/contact) 其他查询. - 电子邮件 [支持@ browserstack.com](mailto:support@browserstack.com)。 。 。 . - 隐私政策: [浏览器stack.com/隐私](https://www.browserstack.com/privacy)。 。 。 . ## 很快会有更多特质出现 保持调用 令人兴奋的更新! 有什么建议吗? 请打开一个问题讨论. ## 常见问题 ### @browserstack/mcp-server 是什么？ 浏览器Stack 的官方 MCP 服务器 ### 如何安装 @browserstack/mcp-server？ 在项目目录运行 npm install @browserstack/mcp-server，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 browserstack-mcp-server，可以用 npx browserstack-mcp-server 直接运行。 ### @browserstack/mcp-server 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @browserstack/mcp-server 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @browserstack/mcp-server 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=20\.9\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @browserstack/mcp-server 可以商用吗？ @browserstack/mcp-server 使用 AGPL-3\.0-only 许可。最严格的 Copyleft：除分发外，通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括，不构成法律意见，请以许可原文为准。 ### @browserstack/mcp-server 的下载量有多少？ 根据 npm 官方下载统计，@browserstack/mcp-server 在 2026/10/09 – 2026/11/07 这 30 天内被下载 110,233 次，日均约 3,674 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @browserstack/mcp-server 还在维护吗？ 最新版本 2\.6\.5 发布于 2026/11/06（2 天前）；至今共发布 193 个版本，其中过去 12 个月发布了 155 个；首次发布于 2025/04/22。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。