@browserstack/mcp-server 1.0.4 → 1.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +34 -14
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -4,6 +4,7 @@
4
4
  <img src="assets/browserstack-logo.png" alt="BrowserStack Logo" height="100"> <img src="assets/mcp-logo.png" alt="MCP Server Logo" width="100">
5
5
  </div>
6
6
 
7
+
7
8
  <div align="center">
8
9
  <a href="https://www.npmjs.com/package/@browserstack/mcp-server">
9
10
  <img alt="NPM Version" src="https://img.shields.io/npm/v/%40browserstack%2Fmcp-server">
@@ -11,10 +12,20 @@
11
12
 
12
13
  </div>
13
14
 
15
+ <p align="center">One Platform For All Your Testing Needs</p>
14
16
 
15
- <h3 align="center">One Platform For All Your Testing Needs</h4>
17
+ <div align="center">
18
+ <a href="https://glama.ai/mcp/servers/@browserstack/mcp-server">
19
+ <img width="380" height="200" src="https://glama.ai/mcp/servers/@browserstack/mcp-server/badge" alt="BrowserStack server MCP server" />
20
+ </a>
21
+ </div>
16
22
 
17
- ## 📖 Overview
23
+ <div>
24
+ <a href="https://www.youtube.com/watch?v=sLA7K9v7qZc">
25
+ <img src="assets/thumbnail.webp">
26
+ </a>
27
+ </div>
28
+
18
29
  Enable every developer and tester in your team, whether they are testing manually, starting their automation journey, or scaling test automation.
19
30
  BrowserStack MCP Server allows you to use our cutting-edge [Test Platform](https://www.browserstack.com/test-platform) directly from your favourite AI tools.
20
31
 
@@ -38,20 +49,17 @@ Use the following prompts to use your **mobile apps** on BrowserStack's extensiv
38
49
  "My app crashed on Android 14 device, can you help me debug?"
39
50
  ```
40
51
 
41
- Video Walkthrough:
42
-
43
- [![Watch the video](https://img.youtube.com/vi/vy1sx0J7sTk/0.jpg)](https://www.youtube.com/watch?v=vy1sx0J7sTk)
44
52
 
45
53
  - Unlike emulators, test your app's real-world performance on actual devices. With advanced [App-Profiling features](https://www.browserstack.com/docs/app-live/app-performance-testing), you can debug crashes and performance issues in real-time.
46
54
  - Access all major devices and OS versions from our [device grid](https://www.browserstack.com/list-of-browsers-and-platforms/app_live), We have strict SLAs to provision our global datacenters with newly released devices on [launch day](https://www.browserstack.com/blog/browserstack-launches-iphone-15-on-day-0-behind-the-scenes/).
47
55
 
48
56
  ### 🌐 Manual Web Testing
49
57
 
50
- Similar to the app testing, you can use the following prompts to test your **websites** on BrowserStack's extensive cloud of real browsers and devices. Don't have a Windows machine to test on Internet Explorer? We've got you covered!
58
+ Similar to the app testing, you can use the following prompts to test your **websites** on BrowserStack's extensive cloud of real browsers and devices. Don't have Edge browser installed on your machine ? We've got you covered!
51
59
 
52
60
  ```bash
53
61
  # Test your local websites
54
- "open my website hosted on localhost:3001 on Internet Explorer"
62
+ "open my website hosted on localhost:3001 on Edge"
55
63
  ```
56
64
 
57
65
  - Test websites across different browsers and devices. We support [every major browser](https://www.browserstack.com/list-of-browsers-and-platforms/live) across every major OS.
@@ -81,10 +89,19 @@ Use the following prompts to run/debug/fix your **automated tests** on BrowserSt
81
89
  1. **Create a BrowserStack Account**
82
90
 
83
91
  - Sign up for [BrowserStack](https://www.browserstack.com/signup) if you don't have an account already.
84
- - Note down your `username` and `access_key` from [Account Settings](https://www.browserstack.com/accounts/profile/details)
85
92
 
86
- 2. **Install the MCP Server**
93
+ - â„šī¸ If you have an open-source project, we'll be able to provide you with a [free plan](https://www.browserstack.com/open-source).
94
+ <div align="center">
95
+ <img src="assets/open-source-plan.png" alt="Open Source Plan">
96
+ </div>
97
+
98
+ - Once you have an account (and purchased appropriate plan), note down your `username` and `access_key` from [Account Settings](https://www.browserstack.com/accounts/profile/details).
99
+
100
+ 2. Ensure you are using Node version >= `18.0`. Check your node version using `node --version`. Recommended version: `v22.15.0` (LTS)
101
+ 3. **Install the MCP Server**
102
+
87
103
  - VSCode (Copilot - Agent Mode): `.vscode/mcp.json`:
104
+
88
105
  ```json
89
106
  {
90
107
  "servers": {
@@ -99,10 +116,12 @@ Use the following prompts to run/debug/fix your **automated tests** on BrowserSt
99
116
  }
100
117
  }
101
118
  ```
102
- * In VSCode, make sure to click on `Start` button in the MCP Server to start the server.
103
- ![Start MCP Server](assets/vscode_install.png)
104
119
 
105
- - For Cursor: `.cursor/mcp.json`:
120
+ - In VSCode, make sure to click on `Start` button in the MCP Server to start the server.
121
+ ![Start MCP Server](assets/vscode_install.png)
122
+
123
+ * For Cursor: `.cursor/mcp.json`:
124
+
106
125
  ```json
107
126
  {
108
127
  "mcpServers": {
@@ -117,7 +136,9 @@ Use the following prompts to run/debug/fix your **automated tests** on BrowserSt
117
136
  }
118
137
  }
119
138
  ```
139
+
120
140
  - Claude Desktop: `~/claude_desktop_config.json`:
141
+
121
142
  ```json
122
143
  {
123
144
  "mcpServers": {
@@ -133,7 +154,6 @@ Use the following prompts to run/debug/fix your **automated tests** on BrowserSt
133
154
  }
134
155
  ```
135
156
 
136
-
137
157
  ## 🤝 Recommended MCP Clients
138
158
 
139
159
  - We recommend using **Github Copilot or Cursor** for automated testing + debugging use cases.
@@ -147,6 +167,7 @@ Use the following prompts to run/debug/fix your **automated tests** on BrowserSt
147
167
  ## 📝 Contributing
148
168
 
149
169
  We welcome contributions! Please open an issue to discuss any changes you'd like to make.
170
+ 👉 [**Click here to view our Contributing Guidelines**](https://github.com/browserstack/mcp-server/blob/main/CONTRIBUTING.md)
150
171
 
151
172
  ## 📞 Support
152
173
 
@@ -160,7 +181,6 @@ For support, please:
160
181
 
161
182
  Stay tuned for exciting updates! Have any suggestions? Please open an issue to discuss.
162
183
 
163
-
164
184
  ## 🔗 Resources
165
185
 
166
186
  - [BrowserStack Test Platform](https://www.browserstack.com/test-platform)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@browserstack/mcp-server",
3
- "version": "1.0.4",
3
+ "version": "1.0.5",
4
4
  "description": "BrowserStack's Official MCP Server",
5
5
  "main": "dist/index.js",
6
6
  "repository": {